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Overview & Installation 


1.1 INTRODUCTION 


The ADSP-2100 Family Development Software is a complete set of 
software design tools. The software includes assembly and C language 
programming tools and processor simulators that facilitate DSP system 
development and debugging. The development software runs on the IBM 
(or IBM-compatible) PC and SUN4 workstation platforms. 


The development software includes several programs: System Builder, 
Assembler, Linker, PROM Splitter, Simulators and C Compiler. This 
manual describes the first five programs, referred to collectively as the 
assembler tools and simulators. 


For information on the ADSP-2100 Family C Compiler, refer to the ADSP- 
2100 Family C Tools Manual & ADSP-2100 Family C Runtime Library Manual, 
respectively. For information on the architecture and system interface of 
each processor, refer to the ADSP-2100 Family User’s Manual. 


The ADSP-2100 Family includes the following processors: 


Processor Description 

ADSP-2100/ADSP-2100A = DSP microprocessor 

ADSP-Z101 DSP microcomputer 

ADSP-2105 DSP microcomputer 

ADSP-2115 DSP microcomputer 

ADSP-2111 DSP microcomputer with host interface port 
ADSP-21msp50/55/56 Mixed-signal DSP microcomputer 
ADSP-2171 DSP microcomputer with host interface port 


This manual provides complete information on developing programs for 
all of the processors. 


Mask-programmable ROM versions of the processors, such as the ADSP- 
2102 and ADSP-2106, are not specifically named in text; however, these 
devices are programmed in the same way as the standard components. 
Other processors added to the ADSP-2100 Family in the future will be 
fully code-compatible, allowing the use of the ADSP-21xx Development 
Software and this manual. 


In this manual, the term “ADSP-21xx” is used generically to refer to one or 
all of the ADSP-2100 Family processors. The term “ADSP-2100” is used to 
denote both the ADSP-2100 and ADSP-2100A. 


Please note that any software features or text references pertaining to boot 
memory, internal or on-chip memory, are applicable to all ADSP-21xx 
processors except the ADSP-2100. This processor has no on-chip memory 
and does not use boot memory. 


Each release of the software is shipped with a Release Note. This note 
describes the current version and provides information on any upgrades to 
the software. Please be sure to return the registration card enclosed 
with your shipment! This allows us to keep you informed about 
subsequent releases of the software. 


1.2 CONTENTS OF THIS MANUAL 


This manual describes the development software in the following 
chapters: | 


e Chapter 2 System Builder 


The system builder is a software tool for describing the target hardware. 
You create a system specification source file which specifies the amount of 
RAM and ROM, the allocation of program and data memory, and 
memory-mapped I/O ports of the target hardware environment. High- 
level constructs are used to simplify this task. 


e Chapter 3 Assembler 


The assembler processes your assembly language programs. It supports 
the syntax of the ADSP-2100 Family instruction set and provides flexible 
macro processing. A C language preprocessor handles C preprocessor 
directives in source code. Source code is partitioned into a defined set of 
modules (files). A full range of diagnostics is provided. 


e Chapter 4 Linker 


The linker processes separately-assembled modules and generates an 
executable memory image file. It can search for library routines to link in. 
It maps the linked code and data to the target system hardware, as 
specified by the system builder output, and can produce multiple boot 
page image files for processors with boot memory. 


e Chapter 5 PROM Splitter 

The PROM splitter reads the linker-output executable file and generates 
PROM burner compatible files in a variety of industry standard formats. 
These file formats are specified in Appendix B. 


e Chapter 6 Simulator Introduction 


This chapter provides an overview of the ADSP-2100 Family Simulator 
Utility. 


e Chapter 7 Getting Started 


This chapter shows you how to invoke the simulator program, then uses 
an example program to demonstrate some of the basic simulator 
operations. Follow the directions in this tutorial to familiarize yourself 
with the simulator and its capabilities. 


Chapters 8 through 12 contain reference material. They cover all simulator 
operations, grouped by function. 


e Chapter 8 User Interface 


This chapter describes all of the elements of the simulator’s user interface. 
It describes how to customize the interface to suit your needs. It covers 
window manipulation, command line operations, and the use of the 
functions keys and mouse. 


e Chapter 9 Registers & Memory 


Register and memory functions allow you to view the contents of all 
processor registers and all locations in memory. In most cases, you can 
change a register or memory location’s contents directly. You can also 
save the contents of memory to files. 


e Chapter 10 Setup & Debug 


Setup includes loading the program to be simulated and configuring 
external inputs. Control and debug functions include starting and 
stopping the execution of your program and resetting the simulated 
processor. You can set breakpoints, break conditions and watchpoints. 
The simulator also provides trace and profile information; the trace 
records bus activity, and the profile records program execution patterns. 


e Chapter 11 I/O Operations 

The I/O functions configure all simulated data input and output. You can 
simulate various types of data transfers through I/O ports, serial ports 
(SPORTs), the host interface port (HIP) and the analog interface. 


e Chapter 12 Miscellaneous Functions 


This chapter describes miscellaneous simulator functions, such as 
evaluating expressions. 


¢ Chapter 13 Command Reference 


This chapter contains summaries of commands and their syntax, window 
operations, and function key definitions. 


These chapters are supplemented by several appendices: 


e Appendix A, Instruction Coding, gives the 24-bit opcode of each 
instruction. 


e Appendix B, File Formats, describes the exact format for input and 
output files used by the development software. 


e Appendix C, Error Messages, lists and defines all error messages 
generated by the development software. 


e Appendix D, Interrupt Vector Addresses, gives the interrupt and 
startup vector addresses for each ADSP-21xx processor. 


e Appendix E, Simulator Error Messages. 


e Appendix F, Simulator Data File Formats. 


1.3 SYSTEM DEVELOPMENT PROCESS 


Figure 1.1 shows a flow chart of the ADSP-21xx system development 
process. The development process begins with the task of defining the 
target system hardware. To define the hardware environment, you use the 
system builder software tool. You must write a system specification file as 
input to the system builder; this file describes the target hardware 
configuration. The system builder reads the file and generates an 
architecture description file which passes information about the target 
hardware to the linker, simulator, and emulator (if used). 


You begin code generation by creating assembly language source code 
modules. An assembly code module is a unit of assembly language 
comprising a main program, subroutine, or data variable declarations. 
Each code module is assembled separately by the assembler. Several 
modules are then linked together to form an executable program (memory 
image file). 
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Figure 1.1 ADSP-21xx System Development Process 
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The linker reads the target hardware information from the architecture 
description file to determine placement of code and data fragments. In the 
assembly modules you may specify each code/data fragment as 
completely relocatable, relocatable within a defined memory segment, or 
non-relocatable (placed at an absolute address). Non-relocatable code or 
data modules are placed at the specified memory address, provided the 
memory area has the correct attributes. Relocatable objects are placed in 
memory by the linker. 


Using the architecture description file and assembled code modules, the 
linker determines the placement of relocatable code and data modules, 
and places all modules in memory locations with the correct attributes 
(CODE or DATA, RAM or ROM). The linker generates a memory image 
file containing a single executable program which may be loaded into a 
simulator or emulator for testing. 


The simulator provides windows that display different portions of the 
hardware environment. To replicate the target hardware, the simulator 
configures its memory according to the architecture description file 
generated by the system builder, and simulates memory-mapped I/O 
ports. This simulation allows you to debug the system and analyze 
performance before committing to a hardware prototype. 


After fully simulating your system and software, an emulator is employed 
in the prototype hardware to test circuitry, timing, and real-time software 
execution. The emulator has overlay memory which can be used in place 
of target system memory components. 


The PROM splitter software tool translates the linker-output program 
(memory image file) into an industry-standard file format for a PROM 
burner. Once you burn the code into PROM devices and plug an 
ADSP-21xx processor into the target board, your prototype is ready to 
run. 


1.4 CONSTANTS 


Constants include numeric constants and symbols defined as constants. 
Symbolic constants may be used anywhere in place of numeric constants. 
The symbol must be declared as a constant with the .CONST directive, for 
either the system builder or assembler. A system builder constant 
declaration does not carry over to the assembler, however—you must 
write new declarations for constants in your assembly source code. 


13 NUMERIC BASES 


The numeric bases which may be used in source code are hexadecimal, 
octal, binary, and decimal. They are specified in the following ways. 


For hexadecimal numbers, prefix a Ox (zero and x) or H#: 
Ox24FF H#CF8A 

For octal, prefix a 0 (zero): 

0777 

Binary numbers are indicated with the prefix B#: 
B#01110100 


For decimal (the default) there is no prefix to denote the base. 
Sign (+ or - ) may be specified: 


1024 +1024 “99 


1.6 CHARACTER SET 


The ADSP-21xx Development Software recognizes the following 
characters: 


e Upper-case letters “A” through “2” 
e Lower-case letters “a” through “z” 
e Digits “0” through “9” 


e ASCII graphics characters—i.e., the printing characters other than 
letters and digits (punctuation, etc.) 


e ASCII non-graphics: space, tab, carriage return, line feed, form feed 
(The “newline” character or characters are interpreted according to the 
conventions of the environment in which they occur.) 


1.7 SYMBOLS 


A symbol is a character string used in one of two ways. Symbols which 
you define in a system builder input file or in assembly language code are 
used to represent something such as a memory segment, address, or data 
value. Other symbols are reserved keywords recognized by the system 
builder or assembler. These reserved symbols are listed in Chapters 2 

and 3. 


A symbol defined in assembly language can be a module name, data 
variable, data buffer, program label, I/O port, macro, or constant. 


Symbols consist of one character from the set: 


e Upper-case letters “A” through “Z” 
e Lower-case letters “a” through “z” 
e The underscore character “_” 


followed by any sequence of characters from the set: 


. Upper-case letters “A” through “Z” 
Lower-case letters “a” through “z” 
The underscore character “_” 
Digits “0” through “9” 


In other words, your symbols may not start with a digit. A symbol may be 
a maximum of 32 characters long. Here are some examples of typical 
symbols and what they might name: 


main_prog assembly language program module 
xoperand data variable 

input_array data buffer 

subroutinel program label 

AtoD_INPUT memory-mapped port 


1.7.1 Case-Sensitivity 

The ADSP-21xx assembly language development software can be set to be 
either case-sensitive, with differentiation between upper and lower-case 
letters, or non-case-sensitive, treating upper and lower-case versions as 
the same character. 


The software tools are by default case-insensitive, and you can enter text 
in any combination of upper and lower-case. The C language, however, is 
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a case-sensitive programming environment, and if the ADSP-2100 Family 
C Compiler is used to generate your programs then the system builder 
and assembler must be set for case-sensitivity. This is accomplished by 
means of an invocation line switch (-c). See Chapters 2 and 3 for further 
details. 


1.8 ASSEMBLER EXPRESSIONS 

The ADSP-2100 Family Assembler can evaluate simple expressions in 
source code. An expression may be used wherever a numerical constant is 
expected. 


Two kinds of expressions are allowed: 
e an arithmetic or logical operation on two or more integer constants 
examples: 29 + 129 (128 - 48) *3 0x55 & Ox0F 
e¢ asymbol plus or minus an integer constant 
examples: data - 8 data_buffer + 15 startup + 2 
The symbols are either data variables, data buffers, or program labels. All 
of these symbols actually represent address values which are determined 
by the linker. Adding or subtracting a constant specifies an offset from the 
address. 
Simple arithmetic or logical expressions can be used to declare symbolic 
constants with the .CONST directive of the system builder and assembler. 
These expressions may use the following operators, which are a subset of 


the operators recognized by the C programming language (listed in order 
of precedence): 


( ) left, right parenthesis 

oa ones complement, unary minus 
eT multiply, divide, modulus 

+ - addition, subtraction 

<< >> bitwise shifts 

& bitwise AND 

| bitwise OR 

m bitwise XOR 


Expressions may also be used when entering commands in one of the 
ADSP-2100 Family Simulators. The simulators recognize an additional set 
of expression elements and operators; these are detailed in the 
“Expressions” section of Chapter 6, Simulator Introduction. 


The most important difference between assembler expressions and 
simulator expressions is that memory contents (such as data variables) 
and processor register contents may be used as operands in the simulator 
only. The assembler cannot evaluate memory and register values at 
assembly-time; the simulator, however, has access to the instantaneous 
values of simulated memory and registers. 
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MANUAL NOTATION CONVENTIONS 


This section provides you with a list of notation conventions used in this 
manual. 


Keywords (system-reserved symbols) are shown in text with 
UPPERCASE characters, although they may actually be entered in 
either upper or lower-case. Both forms of the keyword are reserved. 


A lower-case word highlighted in italics, such as jumplabel, generally 
represents a user-defined symbol such as a program label, data 
variable, or filename. 


Square brackets, [ ], enclose optional items, memory segment size 
(in the system builder’s .SEG directive), or data buffer length (in the 
assembler’s .VAR directive). 


An ellipsis, ... , indicates that the preceding item(s) may be repeated. 


The term ADSP-21xx is used generically to refer to one or all of the 
ADSP-2100 Family processors. 


The term ADSP-2100 is used to denote both the ADSP-2100 and 
ADSP-2100A. 


The acronyms DM, PM, and BM, are used in place of data memory, 
program memory, and boot memory, respectively. 


Since the assembler’s .VAR directive is used for declaring both single- 
word data variables and multiple-word data buffers, the term data 
buffer denotes both variables and buffers. 
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1.10 | SOFTWARE INSTALLATION & RELEASE NOTES 


Details of the software installation procedure may differ from release to 
release; the release note shipped with each new version will provide these 
details. You should always check the release note for new steps to be 
followed when installing the software. 


Installation instructions for the different host platforms are given in 
separate release notes for each. 


1.10.1 Files & Environment Variables 

The installation procedure copies various subdirectories and files onto 
your hard disk. The files are located in a default installation directory or in 
a different directory you have chosen; see your release note for the name 
of the default directory. You should find the following executable 
program files installed: 


Filename Description 

BLD2Z1.EXE System Builder 

ASM21.EXE Assembler C Preprocessor 

ASMPP.EXE Assembler Preprocessor 

ASM2.EXE Assembler 

LD21.EXE Linker 

LIB21.EXE Librarian 

SPL21.EXE PROM Splitter 

HSPL21.EXE HIP Splitter (for use with ADSP-2111 & ADSP-21msp50) 


Future releases of this software may include different files. Consult your 
release note for up-to-date information. 


The following environment variables are created and assigned default 
values by the install program: 


Environment 

Variable Description 

ADIDSP path to the directory containing the installed files 
ADII path(s) to INCLUDE directories, used with Assembler 


This is the complete set of environment variables for the ADSP-21xx 
Development Software including simulators and C compiler. 


All five environment variables are created when you install any portion of 
software. The environment variables are needed for proper operation of 
the software. 


Once the software is successfully installed you are ready to write code and 
use the assembler tools. 


1.10.2 Example Architecture & Source Code Files 

A number of system programming examples are included with the 
development software. These files are located in a directory named 
\EXAMPLES which is installed at the top level of the installation 
directory. The examples are provided to help you learn how to write 
ADSP-21xx programs and use the assembler software. 


The files are named according to an example number. Each example 
includes a .SYS system architecture file, one or more .DSP assembly code 
files, and a .BAT batch file. Executing the batch file will invoke the system 
builder, assembler, and linker in order to create an .EXE executable 
program file which can be loaded and run on an ADSP-21xx simulator. 
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system Builder 


2.1 INTRODUCTION 


The system builder is a software tool for describing your hardware 
environment. Each ADSP-21xx system can have a unique hardware 
configuration and may use different amounts of memory. The system 
builder output specifies your hardware configuration, including memory 
and parallel I/O ports, in a file format read by the linker and simulators. 
The linker requires this information in order to allocate code and data 
storage to the available memory space. The simulators must accurately 
model your system architecture and the ADSP-21xx processor it is based 
on. 


The system builder may also be used to preset the memory map for an 
ADSP-21xx emulator. See the section of this chapter called “Segment 
Mapping For Emulator” for details. 


Figure 2.1 shows the memory configurations available—the maximum 
number of addressable words in each memory space—for each processor. 
The system builder will only allow you to create system architecture 
descriptions within these limits. 


ADSP-2101 
ADSP-2100 ADSP-2105 ADSP-2111 
(all memory external) ADSP-2115 ADSP-21msp50 


Data Memory 14.5K maximum 15K maximum 
(16-bit data) (.5K internal, 14K external ) (1K internal, 14K external ) 


Program Memory 16K mixed code & data 15K maximum 16K maximum 


24-bit code, 16/24-bit data or {K€ lintemnal, 44K ostornal — a 
32K (16K code, 16K data) ( ) (2K internal, ) 


Boot Memory 8K maximum 16K maximum 
(24-bit code, 16/24-bit data, (32K bytes organized (64K bytes organized 
padded to 32-bit word width) in 32-bit words) in 32-bit words) 


Figure 2.1 ADSP-2100 Family Memory Configurations 


Each memory space is addressed separately. Addresses in program 
memory are different from addresses in data memory. Boot memory 
addresses are unique and are used only by the processor during booting. 
(Note: Boot memory does not exist for the ADSP-2100.) 


You must write a system specification source file as input to the system 
builder; this file describes your target hardware. The system builder 
directives described in this chapter are used to write the file. 


The system builder processes the input file and generates an architecture 
description file with the filename extension .ACH. The architecture 
description file is interpreted by the linker in order to place relocatable 
code and data fragments in memory. The file is also read by the simulator 
to model the system memory configuration and by the emulator to set up 
target system memory-mapping. The system builder outputs error 
messages if any are detected, otherwise a summary of the architecture is 
displayed on the screen. You should use operating system commands to 
capture this output into a file if you need to refer to it for debugging or 
documentation purposes. 


System Specification | 
File [.SYS] = 


SYSTEM BUILDER 


Architecture 


nig Error Messages 
Description 


or 
Architecture Summary 
Oe a 4!) 


(Use operating system commands 
to capture screen output) 


File (ACH) 


Figure 2.2 System Builder I/O 


2.1.1. | Memory-Mapped Control Registers 

All ADSP-21xx processors except the ADSP-2100 have a set of memory- 
mapped control registers which configure various modes of processor 
operation. These registers are located in the reserved portion of internal 


data memory on each chip. This memory space is the top 1K of internal 
DM, addresses 0x3C00-0x3FFF. 


You may not declare a memory segment in this space, and the control 
registers cannot be defined in the system builder input file. Instead, each 
register must be initialized in your assembly language programs by 
writing a data word to the appropriate address. (Writes and reads to the 
register locations are allowed even though this segment of memory cannot 
be declared with the system builder’s .SEG directive.) The address and 
format of each control register is given in Appendix E of this manual and 
in the Control/Status Registers appendix of the ADSP-2100 Family User’s 
Manual. 


See the section “Setting the Memory-Mapped Control Registers” in 
Chapter 3 for further information on this topic. 


2.2 RUNNING THE SYSTEM BUILDER 


To invoke the system builder from your operating system, type: 
BLD21 filename[.ext] [-c] 


where filename is your system specification source file. The filename may 
have an extension; if none is present, the system builder appends the 
default extension .SYS to the filename. The system builder will generate 
an output architecture description file called filename.ACH, using the 
filename of your input. 


There is one optional command line switch for the system builder. The -c 
switch makes the system builder case-sensitive, preserving your usage of 
upper and lower-case characters. This option is provided primarily for 
compatibility with the ADSP-2100 Family C Compiler, which is always 
case-sensitive. 


If the -c switch is not used, the system builder output is in all uppercase. 
You must use this switch in order to preserve any lower-case characters 
entered. This is necessary if the assembler is to be run with its case- 
sensitive switch, as is required when assembling compiled C code. If you 


refer (in assembly language code) to a memory segment declared for the 
system builder in lower-case, and the assembler is run in case-sensitive 
mode, the segment name will not be recognized unless it’s case is 
preserved by the system builder. 


If you forget the syntax for invoking the system builder, type: 
BLD21_ -help 


This will show you how the command must be entered. The -help switch 
works with all of the development software tools. 


2.3 SYMBOL USAGE & RESERVED KEYWORDS 


In the system specification file you assign symbolic names to the target 
system itself, to memory segments, and to memory-mapped I/O ports. 
You can use the memory segment names in your program to assign code 
and data fragments to that segment. The assignments are passed from the 
assembler to linker, which determines the exact placement of your 
program in memory. 


All symbolic names must be unique. A symbolic name is a string of letters, 
digits, and underscores with a letter or underscore as the first character. A 
small group of symbols are reserved for use as keywords by the system 
builder—you may not use these symbols in your system specification file. 
Table 2.1 lists the system builder keywords. 


ABS CODE PM 
ADSP2100 CONST PORT 
ADSP2101 DATA RAM 
ADSP2105 DM ROM 
ADSP2111 ENDSYS SEG 
ADSP2150 MMAPO SYSTEM 
BOOT MMAP1 


Table 2.1 System Builder Keywords 


Assembler keywords, listed in Chapter 3, are also reserved for use by the 
development software. Please consult this list also before you choose 
names for your system components. If you use a reserved keyword the 
linker will generate errors when you attempt to link your program. 


2.4 SYSTEM SPECIFICATION FILE 


The system specification source file specifies the amount of data and 
program memory in your system. For those processors with boot memory, 
the file also declares each page of boot memory which will be used. 
Comment fields are enclosed within braces, { }, and may be placed 
anywhere in the file. Nested comments are not allowed. 


You can generate your file with any editor that produces plain text files. 
Do not use a word processor which embeds special control codes. 


2.4.1 ADSP-2100 Example File 

Figure 2.3 is an example of a system specification source file for an 
ADSP-2100 system. (The term “ADSP-2100” is used to denote both the 
ADSP-2100 and ADSP-2100A processors.) 


.SYSTEM fir_system; {system name} 
.ADSP2100; {specifies processor} 
. SEG/PM/ROM/ABS=0/CODE prog_mem[4096]; {code storage} 

. SEG/PM/RAM/ABS=4096/DATA coeff_table[15]; {coefficients table} 
. SEG/DM/RAM/ABS=0/DATA delay_line[15]; {data storage} 

. PORT/DM/ABS=16382 ad_sample; {memory-mapped port} 
. PORT/DM/ABS=16383 da_data; {memory-mapped port} 
-BNDSYS f 


Figure 2.3 ADSP-2100 System Specification File 


The first directive in the file is the SYSTEM directive. This directive 
assigns the name fir_system to the architecture description and marks the 
start of the file. 


The .ADSP2100 statement identifies the processor type, here naming the 
ADSP-2100 microprocessor. This statement is required. 


The .SEG directives declare the system memory segments and their 
characteristics. The memory segments can be declared in any order. In this 
example three segments are declared. 


The first, prog_mem, is a4K-word segment which will store program code. 
The coeff_table segment is 15-word block of program memory declared to 
store data; the data will be a set of FIR filter coefficients. The third 
segment, delay_line, is needed to store intermediate data of the filter 
algorithm. This segment exists in ADSP-2100 data memory. 


The two .PORT directives declare memory-mapped I/O ports for system 
input and output. The port names ad_sample and da_data suggest external 
connections to analog-to-digital and digital-to-analog converters. The 
ports are located at the data memory addresses given with the ABS 
(absolute address) qualifier. The port names become program symbols 
which can be used in code to read or write to the ports. 


The last statement in a system specification file is the .ENDSYS directive. 
The system builder stops processing when it encounters the .ENDSYS 
directive. 


2.4.2 ADSP-2101 Example File 


Figure 2.4 is an example of a system specification source file for an 
ADSP-2101 system. 


The first directive in the file is the SYSTEM directive. This directive 
assigns the name fir_system to the architecture description and marks the 
start of the file. 


The .ADSP2101 statement identifies the processor type, here naming the 
ADSP-2101 microcomputer. This statement is required. 


The .MMAP0 directive specifies the state of the MMAP pin on the 
ADSP-2101 device in this system. Defining MMAP as 0 indicates that boot 
memory is to be loaded into the chip’s internal program memory, 
beginning at address 0x0000. 


The .SEG directive declares the system memory segments and their 
characteristics. The memory segments can be declared in any order. In this 
example, the segments declared comprise the full on-chip and off-chip 
program and data memory configuration of the ADSP-2101. 


.SYSTEM fir_system; {system name} 
.ADSP2101; {specifies processor } 
.MMAPO; {boot loading enable} 
.SEG/ROM/BOOT=0 boot_mem[2048]; {boot page zero} 

. SEG/ PM/RAM/ABS=0/CODE/DATA int_pm[2048]; {internal program mem} 
. SEG/ PM/RAM/ABS=2048/CODE/DATA ext_pm[14336]; {external program mem} 
. SEG/DM/RAM/ABS=0/DATA  ext_dm[14336]; {external data mem} 

. SEG/DM/RAM/ABS=14336/DATA int_dm[1024]; {internal data mem} 

. ENDSYS ; 
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Figure 2.4 ADSP-2101 System Specification File 


(Note: Referring to program memory and data memory does not include 
boot memory, which should be thought of as a unique memory space in 
the system architecture.) 


The boot_mem segment is a 2K-word segment for one page of boot 
memory. If this system was based on the ADSP-2105 rather than 
ADSP-2101, the boot page segment would be 1K (or less) in size. 


The int_pm declaration identifies the 2K-word on-chip program memory 
space starting at absolute address 0. In the ADSP-2101 (as well as 
ADSP-2105, ADSP-2111, and ADSP-21msp50) this memory can store both 
code and data and should be explicitly declared in this way. The following 
statement line declares ext_pm as a 14K-word segment for off-chip 
program memory, starting at address 2048, which may also store code 

and data. 


Next, ext_dm is declared as a 14K-word segment for off-chip data storage 
starting at address 0 (in data memory, as opposed to address 0 in program 
memory). The int_dm segment declares the 1K-word on-chip data memory 
space starting at address 14336. The 1K of on-chip data memory above this 
is reserved for memory-mapped control registers and may not be declared 
as a segment. 


The last statement in a system specification file is the .ENDSYS directive. 
The system builder stops processing when it encounters the .ENDSYS 
directive. 


2.9 SYSTEM BUILDER DIRECTIVES 


This section describes each system builder directive and its syntax. The 
format of some directives requires arguments and qualifiers. Qualifiers 
immediately follow the directive and are separated by slashes; arguments 
follow the qualifiers. The general form of directives is: 


.DIRECTIVE/ qualifier / qualifier ... argument; 


2.5.1. Naming Your System (.SYSTEM) 

The .SYSTEM directive must be the first statement in the system 
specification source file. You name your ADSP-21xx system with the 
symbol given as an argument for this directive. The system name will be 
displayed in the simulator. 


The .SYSTEM directive has the form: 


SYSTEM system_name; 


The .ENDSYS directive must be the last statement in the file. System 
builder processing terminates at the .ENDSYS directive. 


The .ENDSYS directive has the form: 
-ENDSYS; 


2.5.2 Identifying The Processor (.ADSP21 XX) 


This directive identifies which ADSP-2100 Family processor is used in 
your system. This information is passed to the linker and simulator via the 
-ACH output file. The linker is then able to allocate code and data storage 
according to the addressable memory limits of each processor. This 
directive takes one of the following forms: 


.ADSP2100; used for ADSP-2100 & ADSP-2100A 
-.ADSP2101; 

.ADSP2105; 

.ADSP2111; 

.ADSP2150; used for ADSP-21msp50 & ADSP-21msp55 
.ADSP2151; used for ADSP-21msp51 & ADSP-21msp56 


.ADSP2101MV; used for ADSP-2101 memory-variant processor (e.g. ADSP-2115) 
.ADSP2101P; used for ADSP-2101 paged memory system 


When the ADSP-21msp50 Simulator is invoked with an ADSP-21msp51 
architecture file, the simulator automatically configures itself for the on- 
chip memory map of the ADSP-21msp51. If an ADSP-21msp51 
architecture file is used and the ROMENABLE bit is set to 1, the simulator 
configures program memory locations PM[0x800] - PM[0x1000] as ROM. 
The ROMENABLE bit is displayed in the simulator’s Control Registers 
window. 


2.5.3 MMAP Pin (.MMAP) 


This directive is used only for the ADSP-2100 Family processors which 
have on-chip memory, boot memory, and an MMAP pin (ie. all except the 
ADSP-2100). The directive specifies the logic state of the processor’s 
MMAP pin in the target system. 


This directive takes one of two forms: 


.MMAPO MMAP pin held low 
MMAP1 MMAP pin held high 


If MMAP0 is used, boot loading takes place at reset and on-chip program 
memory starts at address 0x0000. If IMMAP1 is used, boot loading is 
disabled and on-chip program memory is mapped to the top (highest 
addresses) of program memory space. 


When this directive is omitted, the simulator default is MMAP=1. 


2.5.4 | Memory Segment Declarations (.SEG) 

The .SEG directive defines a specific section of system memory and 
describes its attributes. There is no default memory map—you must 
define all system memory with .SEG directives. This information is passed 
to the linker, simulator, and emulator via the .ACH output file. 


The .SEG directive has the form: 
SSEG/qualifier/qualifier... seg_namel[length]; 


The segment is assigned the symbolic name seg_name. Assigning a name 
to the segment allows you to explicitly place code and data fragments in 
it. This is accomplished in assembly language with the assembler’s SEG 
qualifier. 


You must specify the segment length inside brackets. This value is 
interpreted as the number of words (either 16-bit data or 24-bit 
instructions) in the segment. 


Data memory segment size in bytes is 2x the word count while program 
memory segment size in bytes is 3x the word count. Boot memory 
segment size in bytes is 4x the word count, due the padding of boot 
memory with an extra byte per word in order to place the beginning of 
each word on an even byte boundary (see Chapter 5, PROM Splitter, for 
further details). 


The following two qualifiers are required for the .SEG directive: 


PM or DM or BOOT=0-7 memory space 
RAM or ROM memory type 


Four others are optional: 


ABS=address absolute start address 

DATA or CODE or DATA/CODE _ what is stored in segment 
EMULATOR or TARGET preset emulator memory map 
INTERNAL located in on-chip memory of ADSP- 


2101 memory-variant processor 


The PM/DM/BOOT qualifier indicates which memory space the segment 
is in: program memory, data memory, or boot memory. (Remember that 
boot memory space does not exist for the ADSP-2100.) The remaining 
qualifiers specify the memory type, the starting address of the segment, 
what is stored (DATA and/or CODE), and how the emulator’s memory 
map is preset. 


If you are using one of the ADSP-21xx emulators, see “Segment Mapping 
For Emulator” below. 


Each memory space is addressed separately: address 16 in program 
memory is different from address 16 in data memory. 


PM memory segments can store CODE only, DATA only, or both CODE 
and DATA. If you give neither of these qualifiers the default is to CODE. 
For a PM segment to contain code and data, both qualifiers must be used. 
The ADSP-21xx processors require that any data transfers to or from 
program memory must be made with segments which have the DATA 
attribute. If your system requires that executable code be written or read 


by the processor, the segments to be accessed should be declared with 
both the CODE and DATA qualifiers. 


DM memory segments must be DATA only; this is the default if the 
DATA qualifier is omitted. An error is generated if a DM segment is 
assigned the CODE attribute. 


BOOT memory segments default to both CODE and DATA since boot 
memory will store both in most systems, and the qualifiers may be 
omitted. The BOOT qualifier must specify one page number only: for 
example, BOOT=0. You must have a separate segment declaration for each 
boot page of your system. 


A system may have up to 8 boot pages, with page numbers from 0 to 7. 
Each ADSP-2101, ADSP-2111, and ADSP-21msp50 boot page can store up 
to 2K words of code and data. Each ADSP-2105 and ADSP-2115 boot page 
stores up to 1K words. Do not use the ABS qualifier for boot pages—the 
system builder assigns appropriate boundary addresses. 


2.5.4.1. .SEG Directive Examples 


The example 
. SEG/PM/RAM/ABS=0/CODE/DATA restart[2048]; 


declares a program memory RAM segment called restart which is located 
at address 0. The segment may hold 2048 words of code and data. 


The example 
.SEG/ROM/BOOT=0 boot_mem[1536]; 


declares the boot memory segment boot_mem which is located on boot 
page 0 (automatically corresponding to address 0 in boot memory). The 
length of the segment is 1536 words. Boot memory segments should 
always be ROM. 


2.5.4.2 Segment Mapping For Emulator 

The system builder allows you to preset the memory map for an 
ADSP-21xx emulator via the .ACH file. Two optional qualifiers of the 
.SEG directive are used for this purpose: 


/EMULATOR maps segment to emulator overlay memory 
or 
/TARGET maps segment to target board memory 


These settings will configure the emulator’s memory map when the 
emulator program is invoked. The segments must be mapped in blocks of 
1K or larger. Once the emulator is running you can change the memory 
map with emulator commands. 


If you are using the emulator in standalone mode (i.e. without a target 
board), you must map all memory segments to EMULATOR. You may 
also want to map all segments to EMULATOR during the initial stages of 
hardware/ firmware integration. Consult your ADSP-21xx Emulator 
Manual for further information. 
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2.5.5 | Memory-Mapped I/O Ports (.PORT) 


The .PORT directive declares a memory-mapped I/O port. You must 
assign a unique name and address to each port in your system. Ports can 
be located in either data or program memory. For those processors with 
internal memory, ports may be assigned addresses in external memory 
only. 


The .PORT directive takes one of two forms: 


-PORT/DM/ABS=address port_name; 
or 
-PORT/PM/ABS=address port_name; 


The DM qualifier indicates that the port is located in data memory; PM 
indicates placement in program memory. If neither qualifier is used, the 
default is to DM. The port is located at the absolute address you specify 
(with the ABS qualifier), and is assigned the symbol port_name. This 
symbol can be used in assembly language instructions to access the port. 


For example, 
. PORT /DM/ABS=0x0400 ad_sample; 


declares a port named ad_sample which is located at data memory address 
1024 (decimal). Assembly code references to this symbol are interpreted 
by the linker based on the contents of the .ACH file. 


Data memory-mapped ports allow 16-bit read/writes while program 
memory-mapped ports allow either 16 or 24-bit transfers. (Refer to the 
ADSP-2100 Family User’s Manual for a description of 24-bit data transfers 
in program memory.) 


2.5.6 | System Builder Constants (.CONST) 


The .CONST directive defines system builder constants. Once you declare 
a symbolic constant you may use it in place of the actual number. This 
symbol definition is recognized only by the system builder, however—it is 
not carried over to the assembler or simulator. 


The .CONST directive has the form: 


-CONST constant_name = constant or expression, ... ; 


Only an arithmetic or logical operation on two or more integer constants 
may be given as an expression; symbols are not allowed. See “Assembler 
Expressions” in Chapter 1 for an exact definition of allowed expressions. 


A single .CONST directive may contain one or more constant declarations, 
separated by commas, on a single line. A list of multiple declarations may 
not be continued on the following line. 


To equate the symbol taps to 15, for example, you would give the .CONST 
directive as follows: 


CONST taps=15;> 


2.6 PROCESSOR-SPECIFIC CONSIDERATIONS 

Due to several unique characteristics of the ADSP-2100, ADSP-2105, and 
ADSP-2115, the following guidelines should be kept in mind when 
writing system specification files for these processors. 


2.6.1 ADSP-2100 Systems 
Two different program memory configurations are possible for the 
ADSP-2100: 


¢ 16K words of mixed code and data 
or 
¢ 32K words—16K of code only, 16K of data only 


The 32K extended configuration requires the use of the processor’s PMDA 
output as an additional (high-order) address line for program memory. If 
this configuration is employed, the lower 16K must be code-only. PM 
segments declared in this region must have the CODE qualifier only. The 
upper 16K space must be data-only. PM segments declared in this region 
must have the DATA qualifier only. 


If your ADSP-2100 system includes the 32K extended program memory 
space, the system builder will generate an error message if you attempt to 
declare a PM segment with both the CODE and DATA qualifiers. 


2.6.2 ADSP-2105 & ADSP-2115 Systems 

Since the ADSP-2105 and ADSP-2115 has half the internal memory of the 
ADSP-2101, the internal memory space which may be declared is limited 
by the system builder. You may not declare memory segments in any 
portion of the following address ranges: 


Internal DM addresses 14848-15359 (0x3A00-0x3BFF) 
Internal PM addresses (MMAP=0) 1024-2047 (0x0400-0x07FF) 
Internal PM addresses (MMAP=1) 15360-16383 (Ox3C00-0x3FFF) 


These ranges correspond to the ADSP-2101’s upper 1K of internal PM and 
upper 2K of internal DM, which are not present in the ADSP-2105/ ADSP- 
2115. Since the linker extracts information from the .ACH file generated by 
the system builder, it will not allocate any code or data to these memory 
ranges. 


The ADSP-2101 simulator is used for simulation of ADSP-2105 and ADSP- 
2115 systems. When you invoke this simulator with an ADSP-2105 
architecture file or ADSP-2115 (.ADSP2101MV memory variant) 
architecture file it configures itself for the different amount of on-chip 
memory. The portions of on-chip memory of the ADSP-2101 which do not 
exist in these processors will be displayed as non-existent. 


2.6.2.1 Generating 1K Boot Pages 

Since the ADSP-2105 and ADSP-2115 have 1K-size boot pages, your boot 
page declarations should specify segment sizes of 1024 or less. For 
example: 


.SEG/BOOT=0/ROM page_0[1024]; 


When you later use the PROM splitter to prepare burn files for the boot 
PROM devices, you must use the PROM splitter’s -bs switch to generate 
1K-size pages. (See Chapter 5, PROM Splitter, for details.) 


2.6.2.2 2105/2115 To 2101 Upgrade 
The ADSP-2105 and ADSP-2115 are pin-compatible with the ADSP-2101, 
providing a direct upgrade option for your system. A few details 


concerning the upgrade should be kept in mind when designing the 
ADSP-2105/ ADSP-2115 system. 


You will be able to upgrade without hardware modifications if you 
initially design your hardware and firmware to use 2K-size boot pages 
(which store only 1024 words). To do this you should declare 2048-word 
boot page segments, such as: 


.SEG/BOOT=0/ROM page_0[2048]; 


Since your ADSP-2105/ADSP-2115 program must be booted in 1K pages, 
boot memory for the system will (at first) have an unused 1K of memory 
between each page of ADSP-2105 code/data. The processor will correctly 
boot each 1K page of the program, however, ignoring the blank segments 
in between. 


In other words, the 2K-size boot pages will have code/data only in the 
lower half of each page (word addresses 0-1023)—the upper half will be 
blank. When you upgrade the system to the ADSP-2101, you can then use 
the PROM splitter to generate full-size 2K boot pages for your program. 


2.7 ADSP-2101 MEMORY-VARIANT PROCESSORS 


Memory-variant processors such as the ADSP-2115 are ADSP-2101 
derivatives that contain varying on-chip memory configurations. The data 
sheet for each of these devices specifies its memory configuration. To 
support simulation of ADSP-2101 memory variants, the development 
software lets you easily configure the system architecture file and 
simulator for the specific memory-variant processor you are using. 


Systems based on a memory-variant processor may be defined with any 
amount of program memory (PM) from 0 - 16K words and with any 
amount of data memory (DM) from 0 - 15K words. Portions of PM and 
DM memory space may be freely defined as either ROM and/or as 
INTERNAL (i.e. on-chip). You make these definitions in the SYS system 
architecture file you write. After the system builder processes your .SYS 
file, the .ACH file created is read by the linker and ADSP-2101 Simulator. 


Here are the steps to follow for simulating an ADSP-2101 memory-variant 
processor: 


1. Use the following system builder directive in your .SYS system 
builder input file: 


.ADSP2101MV 
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2. For any of your memory segments located in the memory-variant 
processor’s on-chip memory, use the /INTERNAL qualifier on the 
corresponding .SEG directive (in your .SYS file). 


3. For any of your memory segments which are ROM, use the /ROM 
qualifier on the corresponding .SEG directive. 


4. Assemble, link, and simulate your program in the usual fashion. The 
linker and ADSP-2101 Simulator will read the .ACH architecture file 
generated by the system builder, defining internal and/or ROM 
memory segments accordingly. 


2.8 DESIGNING PAGED MEMORY SYSTEMS 


The development software lets you design ADSP-2101 systems that 
address a larger external memory space by implementing a paged data 
memory scheme. Only data memory may be extended in this way, not 
program memory. 


Figure 2.5 shows an example of this type of system, with the data memory 
of the ADSP-2101 extended with three additional pages. Page 0 is the 
standard 16K data memory space of the ADSP-2101. Ina paged memory 
system, page 0 is divided into data space, I/O space, and on-chip data 
memory (addresses 0x3800 - Ox3FFF). 


The value of PAGESIZE, which you must specify in the system builder, 
determines the boundary between the data space and I/O space. The value 
of DMIOEND, which you must also specify and which cannot be larger 
than 0x37FF, is the last address of I/O space. The I/O space will contain 
memory-mapped I/O ports as well as a special memory-mapped location: 
the DM page register. 


The code modules, data buffers, and data variables that you store in paged 
memory must be confined to their own page, and may not cross page 
boundaries. 


2.8.1 System Builder Features For Paged Memory 

You must use the .ADSP2101P directive to generate a .ACH architecture 
file for a paged memory system. To create 4K-size pages, for example, you 
would use the following directive statement in your .SYS input file: 


.ADSP2101P/PAGESIZE=4096; {Paged memory system, } 
{ 4K pagesize} 


DM Page Register DM Page Register DM Page Register DM Page Register 


0x0000 0x0000 0x0000 0x0000 
Cini Vislinabis data space data space data space data space 
Page Size 
PAGESIZE PAGESIZE PAGESIZE 


ie) anaae PAGESIZE 
DMPGREG [on eee ceased 
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On-Chip 
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Figure 2.5 ADSP-2101 Paged Data Memory System 


The PAGESIZE qualifier defines the number of data space words in each 
memory page. Default page size is 8192 if the PAGESIZE qualifier is 
omitted. 


You must also use the system builder to define a DM page register for 
your system. The page register is used to address different pages. In the 
example of Figure 2.5, the DM page register numbers the data memory 
pages from 0 to 3. 


The DM page register must be defined as a memory-mapped location with 
the .PORT directive, and must be named DMPGREG. To locate the DM 
page register at address 8192 (0x2000) in data memory, for example, the 
following statement would be used: 


. PORT/DM/ABS=0x2000 DMPGREG; {DM page register} 


The DM page register must be implemented as a memory-mapped 
register in your system hardware. The register’s outputs should be used as 
the upper address lines for all data memory; these lines will select 
between the different pages. Figure 2.6 shows an example hardware 
configuration which implements 16 pages of DM, each with 8K words of 
16-bit data storage. 


ADSP-2101 


8-Bit Latch 
Decoded Write Line 


D13 
D12 
D11 
D1i0 
D9 
D8 


128K x 8 128K x 8 


ADDRESS 


Figure 2.6 128K Paged Data Memory System 


2.8.2 Using Segment Names For Pages 

A special syntax of the /ABS qualifier (of system builder’s .SEG directive) 
lets you define and name a memory segment which is located on a specific 
page of data memory. The format of this directive is: 


SSEG/qualifiers/ ABS=pg#:addr seg _name|seg_ length]; 


This syntax specifies the page number and starting address (in decimal 
format, from 0 to 16,383) of the segment. The DM, RAM/ROM, and 
DATA qualifiers must also be given. 


For example, to define segment names for the data memory pages shown 
in Figure 2.5, the following directives would be used: 


. SEG/DM/RAM/DATA/ABS=0: 0 pageO0 [4096] ; 
. SEG/DM/RAM/DATA/ABS=1: 0 pagel [4096]; 
. SEG/DM/RAM/DATA/ABS=2:0 page2 [4096]; 
. SEG/DM/RAM/ DATA/ABS=3 : 0 page3 [4096]; 


Your C source and/or assembly source modules can now be placed in one 
of these page-specific segments by using the assembler’s /SEG qualifier or 
the C compiler’s -DMSEG switch. 


2.8.3 Assembler Features For Paged Memory 

The assembler recognizes a special directive that designates paged 
memory systems. This directive, .PAGE, must be used in all assembly 
source modules that are part of the paged memory system: 


. PAGE; 


A new assembler operator, PAGE buffer_name, can be used to extract the 
page number (upper address bits) of a data buffer/data variable: 


AXO=PAGE array0O; {Get page number of array0} 


This instruction determines the page number of the buffer array0 and 
loads it into AX0. Note that the PAGE operator works like the assembler’s 
address pointer (“) and length of (%) operators. 


2.8.4 C Compiler Features For Paged Memory 

The C compiler has several invocation switches that support paged 
memory systems. When compiling code for a paged memory system, use 
the -FARDATA switch: 

CC21 sourcefilec -FARDATA 


The -FARDATA switch tells the compiler that the data variables and 
arrays in sourcefile.c will be used in a paged memory system, and that page 
addressing information (i.e. high-order address bits) is to be generated for 
these variables/arrays. For the variables and arrays located in DM, the 
compiler generates code that uses the page number contained in the DM 
page register (DMPGREG, previously defined in the system builder). 


If you use the -FARDATA switch to store data in paged memory, you 
must define segment names into which your data is placed by the 
compiler. The -FARDATA switch instructs the compiler to locate all DM 
data from sourcefile.c in a default DM segment named DDEFAULT. You 
must define the DDEFAULT segment in the system builder before 
compiling and linking. For the example system shown in Figure 2.5, 
page 0 could be defined as the DDEFAULT segment with the following 
system builder statement: 


. SEG/DM/RAM/DATA/ABS=0: 0 DDEFAULT [4096] ; 


The compiler’s -DMSEG switch can be used to override default placement. 
For example, to locate the DM data from srcl.c in a memory segment 
named table3 (instead of DDEFAULT), the compiler would be invoked 
with this command line: 


cc21 srcl.c -fardata -dmseg table3 


The -FARDATA switch has several other effects on the compiled code and 
on the C runtime environment: 


1. The runtime stack will be located in the ADSP-2101’s internal 
memory. Default placement is in DM, unless the compiler’s 
-pmstack switch is used. 


2. The compiler assigns a single page of data memory to each 
compiled function. When the function is executed, it will only 
be able to access DM-resident data on that page. 


3. Some of the functions of the Runtime C Library use a small 
amount of memory—this memory will be located the ADSP- 
2101’s internal memory. 


2.8.5 Using Paged Addresses In Simulator 

When simulating a system with paged memory, you can specify memory 
addresses with page information while working in the ADSP-2101 
Simulator. The syntax for paged memory addresses includes the page 
number and address (in decimal format, from 0 to 16,383): 


syntax example 
DM(pe#:addr) dm (0:8193) 


Assembler 


3.1 INTRODUCTION 


The ADSP-2100 Family Assembler translates your assembly language 
code into object code. A unit of assembly language code is called a 
module; the modules you input to the assembler are called source 
modules. Each source module must be contained in a separate file. 
Separately-assembled modules are linked together to form a single 
executable program. 


Your source code is written in ADSP-21xx assembly language or 
generated by the ADSP-2100 Family C Compiler. Assembler directives are 
used to define data variables, data buffers, and macros. You can create 
source code files with any editor that produces plain text files. Do not use 
a word processor which embeds special control codes. 


Various programming techniques are explained throughout this chapter. 
Additional information and program examples can be found in the “Using 
Library Files Of Your Routines” and “Multiple Boot Page Systems” 
sections of Chapter 4. 


Figure 3.1, on the following page, shows the assembler input and output 
files. The assembler reads the input file and generates four types of output 
files: an object file (.OBJ), a code file (.CDE), a list file (.LST), and 
initialization file(s) (.INT). The object file, code file and initialization files 
are passed to the linker. The object file contains information about 
memory allocation and symbol definitions. Memory allocation is the 
process in which the linker decides where to store your program’s code 
and data fragments. The code file contains ADSP-21xx instruction opcodes 
with unresolved symbols marked. Initialization files contain data for 
initializing data buffers. The list file, which is optional, gives you 
information to help understand and document the assembly process. 


(Note: Since the assembler’s .VAR directive is used for declaring both 
single-word data variables and multiple-word data buffers, the term “data 
buffer” is used to denote both variables and buffers.) 
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Figure 3.1 Assembler I/O 


3.2 ASSEMBLER PREPROCESSORS 


The assembler has three executable components: 


e C language preprocessor 
e assembler preprocessor 
* core assembler 


The two preprocessors of the assembler are an ANSI-standard C language 
preprocessor and an assembler preprocessor. The C preprocessor handles 
C directives such as #define and #include. The assembler preprocessor 
handles ADSP-21xx assembler directives such as. MODULE and .VAR. 
Figure 3.2, on the following page, shows the flow of assembler execution. 


The assembler’s C preprocessor allows the use of C preprocessor 
directives such as #include in assembly code. The C preprocessor handles 
these directives in the same way as a compiler’s preprocessor would. See 
Section 3.5, “Using The C Preprocessor” for examples of how to use this 
feature. 


Note that the C preprocessor cannot accept assembler-style comments 
enclosed in brackets, { }. To place a comment on the same line as a C 
preprocessor directive (beginning with the “#” character), use the C 
convention for comments: 


#directive /* comment */ 


3.3 RUNNING THE ASSEMBLER 


To invoke the assembler from your operating system, enter: 
ASM21 filename|.ext] [-switch ...] 


Filename is the input file, which must contain only one source code 
module. The filename may have any extension; if none is present, the 
assembler appends the default extension .DSP to the filename. 


The optional invocation switches control various aspects of assembler 
execution. They may be entered in either upper or lower-case. Multiple 
switches must be separated by at least one space. 


“ASM21” 


Figure 3.2 Assembler Execution Flow 


C Preprocessor 


Assembler Preprocessor 


Core Assembler 


.CDE File : 


-OBJ File 


If you forget the syntax for invoking the assembler, type: 
asm21 -help 


This will show you how the command must be entered and will display a 
list of the available switches. The -help switch works with all of the 
development software tools. 


If you are assembling source code generated by the ADSP-21xx C 
Compiler, the assembler must be invoked with its -c and -s switches. Since 
the compiler and the C environment are normally case-sensitive while the 
assembler is not, the -c switch must be used to make the assembler case- 
sensitive also. The -s switch should be given because the compiler may 
generate multifunction instructions which are not in the conventional, 
logical sequence. These instructions will, however, assemble and execute 
correctly. Consult the ADSP-2100 Family C Tools Manual & ADSP-2100 
Family C Runtime Library Manual for further information. 


3.3.1 Assembler Switch Options 


The assembler switches are listed below in Table 3.1; some require 
arguments as shown. 


Switch Effect 

-¢ Make assembler case-sensitive 

-didentifier|=literal] Define identifier for C preprocessor 

-i [depth] Show contents of INCLUDE files in .LST file 

-| .LST list file generated 

-m [depth] Macros expanded in .LST file 

-o filename Rename output files 

“5 No semantics checking on multifunction 
instructions 

-2159 Assembles instructions unique to 
ADSP-21msp5x processors 

-2171 Assembles instructions unique to ADSP-217x 
processors 

-2181 Assembles instructions unique to ADSP-2181 
processor 


Table 3.1 Assembler Switches 


3.3.2  Case-Sensitivity (-c) 

The -c switch causes the assembler to be case-sensitive, primarily for 
compatibility with code compiled by the ADSP-2100 Family C Compiler. 
The C language is a case-sensitive environment. If the -c switch is not 
given, the assembler will not differentiate between upper and lower-case 
characters and all symbols will be output in upper-case. You must use this 
switch in order to preserve any lower-case characters entered. 

If you are assembling source code produced by the compiler, you should 
use the -c switch when invoking the assembler. (Normally the compiler 
itself invokes the assembler, using the -c switch in the call.) 


3.3.3 Define An Identifier (-d) 


The -d switch defines a C-style identifier for the assembler’s C 
preprocessor in the same way as the #define directive. The switch is given 
in the following manner: 


-didentifier|=literal] 
The identifier is a string of characters and digits, as specified by the C 
standard. This specification is the same as that for an ADSP-21xx assembly 
language symbol. The identifier may be set equal to a C literal—either a 
constant or string literal. 
Here are some examples of the -d switch: 
-Djunk 
-dten=10 
-dname=”" Jake” 
One way to use the -d switch is shown in the following assembly code: 
CNT R=f 
DO this_loop UNTIL CE; 


this loop: ... {last instruction of loop} 


Now you can choose a value for the loop counter n when you invoke the 
assembler. Assume that this_loop is in your input file named source_file: 


asm21 source file -dn=100 


See the section “Using The C Preprocessor” for an example of using the -d 
switch to implement conditional assembly. 


3.3.4 Expand INCLUDE Files In List File (-i) 

The -i [depth] switch causes the contents of files named with the 
assembler’s .INCLUDE directive to be shown in the .LST output file. 
Specifying a value for [depth] determines the depth of nested INCLUDE 
files to be shown. If depth is not specified, then all nested files are 
expanded. Here are two examples of the -i switch: 


-1 
-13 


If the -1 switch is not used, these directives remain in the form “.INCLUDE 
filename.” See the “Including Other Source Files” section of this chapter for 
further information. 


3.3.5 Generate Listing File (-l) 


The assembler produces a list file (.LST) if the -1 switch is given. This file 
provides address and opcode information to help you interpret the 
assembly results. The format of the .LST file is described in “List File 
Format” at the end of this chapter. 


3.3.6 | Expand Macros In List File (-m) 


The -m [depth] switch causes the assembler to expand your macros in the 
.LST file. This means that the complete set of instructions executed by the 
macro will be shown. Specifying a value for [depth] determines the depth 
of nested macro calls to be expanded. If depth is not specified, then all 
nested macro calls are expanded. Here are two examples of the -m switch: 


-m 
-m 2 


If the -m switch is not used, these directives retain the form of their single- 
line invocation (e.g. “macroname”). See the “Macros” section of this chapter 
for further information. 


3.3.7. Renaming Output Files (-o) 

The -o switch can be used to rename the assembler’s output files (OBJ, 
.CDE, .INT, .LST). For example, if your input file is named sourcel.dsp 
and you want to rename the output files srcl.obj, srcl.cde, 
srcl.int,and srcl.1st, invoke the assembler in this way: 


Astizi eourcel =o erecl 


3.3.8 Disable Semantics Checking (-s) 


Giving the -s switch prevents the assembler from checking the semantics 
(conventional ordering) of multifunction instructions in your code. 


ADSP-21xx multifunction instructions may have multiple clauses which 
have a logical left-to-right ordering. The clauses may, however, be listed in 
a different order and still assembled correctly. If this happens the 
assembler normally generates a warning message for you; the -s switch 
switch inhibits these warnings. 


As long as the individual clauses of a multifunction instruction are legal, 
the proper opcode will be generated regardless of the order in which they 
are given. The assembler’s warning messages are only intended to point 
out instructions which may appear confusing or misleading. 


3.4 ASSEMBLY LANGUAGE CONVENTIONS 


This section describes language conventions specific to the assembler. See 
Chapter 1 for a complete discussion of conventions including numeric 
bases, character set, symbols, and manual notation. 


3.4.1. Symbols & Keywords 

Symbols and keywords are character strings. A symbol is a string which 
you define in assembly language; the symbol can be a module name, data 
variable, data buffer, program label, I/O port, macro, or constant. A 
symbol may be a maximum of 32 characters long and may not start with a 
digit (“0”-“9”). Here are some examples of typical symbols and what they 
might name: 


main_prog assembly language program module 
xoperand data variable 

input_array data buffer 

subroutine program label 

AD_INPUT memory-mapped port 


Symbols may be entered in any combination of upper and lower-case 
characters, but the assembler will convert all characters to upper-case if 
the -c switch is not used. Examples of symbols and filenames are shown in 
italics throughout this manual. 


The same symbol may be declared and separately used in different source 
code modules. Symbols are recognized only within the scope of the local 
module—unless they are declared as GLOBAL or ENTRY. This type of 
symbol can be referenced by all modules and must originate in one 
module only. See the descriptions of the assembler’s .GLOBAL, .ENTRY, 


and .EXTERNAL directives later in this chapter. 


Table 3.2 lists the reserved assembler keywords. You may not use a 
keyword as a symbol in your code. Because the assembler is case- 
insensitive by default, both the upper and lower-case versions of 
keywords are reserved. Keywords are shown in UPPERCASE throughout 


this manual. 


AV 


AX0 


ENDMACRO 


ENDMOD 
ENTRY 

EQ 

EXP 
EXPAD] 
EXTERNAL 
FOREVER 
FLAG_IN 
FLAG OUT 


INCLUDE 
INIT 


Table 3.2 Assembler-Reserved Keywords 


NEG 


REGBANK 
RESET 
RND 

ROM 

RTI 


TOGGLE 


Assemk 


3.4.2 Assembler Expressions 

The ADSP-2100 Family Assembler can evaluate simple expressions in 
source code. An expression may be used wherever a numerical value is 
expected. 


Two kinds of expressions are allowed: 
e an arithmetic or logical operation on two or more integer constants 
examples: 29 + 129 (128 - 48) *3 Ox55 & Ox0F 
¢ asymbol plus or minus an integer constant 
examples: data - 8 data_buffer + 15 startup + 2 


The symbols are either data variables, data buffers, or program labels. All 
of these symbols actually represent address values which are determined 
by the linker. Adding or subtracting a constant specifies an offset from the 
address. 


(Note: Since the assembler’s .VAR directive is used for declaring both 
single-word data variables and multiple-word data buffers, the term “data 
buffer” is used to denote both variables and buffers.) 


Simple arithmetic or logical expressions can be used to declare symbolic 
constants with the .CONST directive of the system builder and assembler. 
These expressions may use the following operators, which are a subset of 
the operators recognized in the C language environment (listed in order of 
precedence): 


( ) left, right parenthesis 

~~ ones complement, unary minus 
*/ % multiply, divide, modulus 

+ - addition, subtraction 

<< >> bitwise shifts 

& bitwise AND 

| bitwise OR 

bitwise XOR 


Expressions may also be used when entering commands in one of the 
ADSP-2100 Family Simulators. The simulators recognize an additional set 
of expression elements and operators. 


The most important difference between assembler expressions and 
simulator expressions is that memory contents (such as data variables) 
and processor register contents may be used as operands in the simulator 
only. The assembler cannot evaluate memory and register values at 
assembly-time; the simulator, however, has access to the instantaneous 
values of simulated memory and registers. 


3.4.3 Buffer Address & Length Operators 


Two special operators are recognized by the assembler. The address 
pointer (“) and length of (%) operators are used with data buffer names: 


“buffer_name is evaluated as the base (first) address of the buffer 
%buffer_name is evaluated as the length (number of words) of the buffer 


The “ operator can also be used with variables, which are simply single- 
location buffers: 


“variable_name gives the address of the variable 


Simple expressions may be created by adding or subtracting a constant 
from the operator term: 


“buffer_name + constant 
Jobuffer_name + constant 


For example: 


“array + 3 
array - 10 
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The assembler operators are used to load L (length) and I (index) registers 
when setting up circular buffers: 


. VAR/DM/RAM/CIRC real_data[n]; {n=number of | } 
{input samples} 


15=“real_data; {buffer base address} 
L5=Sreal data; {buffer length} 

M4=1; {post-modify I5 by 1} 
CNTR=%real_data; {loop counter=buffer length} 
DO loop UNTIL CE; 

AXO=DM(1I5,M4) ; {get next sample} 


{now process sample stored in AX0} 
LOOD €s«. 


This code fragment initializes I5 and L5 to the base address and length, 
respectively, of the circular buffer real_data. The buffer length value 
contained in L5 determines when addressing wraps around to the top of 
the buffer. Further information on circular buffers can be found in the 
“Data Variables & Buffers” section of this chapter and in the Data Transfer 
chapter of the ADSP-2100 Family User's Manual. 


3.4.4 |Comments 


You may insert comments anywhere in a source code file, enclosed by 
braces, { }, except on C preprocessor directive lines. Nested comments 
are not allowed. 


Multiple-line comments enclosed by a single pair of braces may not have a 
pound sign (“#”) at the beginning of any line. 


Assembler directives may only have one-line comments—the comment 
cannot be continued on the following line. If you need more space to 
continue a comment, begin a new comment field on the next line. 


Note that the C preprocessor cannot accept assembler-style comments 
enclosed by braces. To place a comment on the same line as a C 
preprocessor directive (beginning with the “#” character), use the C 
convention: 


#directive /* comment */ 


3.9 USING THE C PREPROCESSOR 

The ADSP-21xx assembler includes a C preprocessor which allows you to 
use directives such as #define, #ifdef, #include, etc. in your assembly 
language code. The preprocessor handles these directives as well as any 
related code (e.g. expansion of macros created with the #define directive). 


The C preprocessor directives which can be used are as follows: 


Directive Meaning 

#include Insert text from another source file 

#define Define a macro 

#undef Remove a macro definition 

#if Conditionally include text, depending on the value of 
an expression that evaluates to a constant 

#ifdef Conditionally include text, depending on whether a 
macro name is defined 

#ifndef Conditionally include text, with the logic of the 
test opposite that of #ifdef 

#else Include text if the previous #if, #ifdef,or #ifndef 
test failed 

#endif Terminate conditional text 


These directives allow various programming techniques. For example, 
you can implement conditional assembly or define macros by using the C 
preprocessor directives #ifdef and #define. An example of each of 
these is given below. 


3.5.1 Example: Conditional Assembly 

The assembler’s -d switch is intended for use in conjunction with the C 
preprocessor. This switch allows you to define a C-style identifier for the 
preprocessor, just as the #define directive does. A common use of this 
capability is to implement conditional assembly, as shown in the 
following example. 


If a portion of assembly code is written only for debugging, it can be 
included in a module of your main program and conditionally assembled 
when desired. To allow this, the debug code should be placed inside an 
#ifdef block which is evaluated by the C preprocessor. 
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Take the following block of code, for example: 

#ifdef debug /* assemble if debug is defined */ 
7 debug assembly code 

#endif 7 


If debug is defined with the -d switch, the C preprocessor will delete the 
#ifdef and #endif directives, leaving the debug code in place for the 
assembler; the debug code will be assembled into the program module. If 
debug is not defined, then the C preprocessor will delete the entire block 
prior to assembly. 


In order to preserve and assemble the debug code, the assembler would be 
invoked in this way: 


asm21 source_file -ddebug 


3.5.2 Example: C-Style Macros 

While the assembler’s MACRO directive allows you to create macros in 
your source code (see “Defining Macros” later in this chapter), the C 
preprocessor can also be employed to define macros. This is accomplished 
with the #define preprocessor directive, in exactly the same way as in C. 


Here is a simple example: 
#define mac MR=MR+MX0*MYO0 (RND) 


AR=AX1-AY1; 
MYO=AR; 
MXO=DM(1I1,M0); 
Mac; 


In this case the macro mac is defined as an ADSP-21xx multiply- 
accumulate instruction. The macro is replaced by this instruction 
everywhere it appears in your source code. Notice that the #define 
directive line does not require a terminating semicolon but the macro 
invocation does. 


A macro invocation may not contain additional program statements (i.e. 


instructions, preprocessor directives, or other macro invocations) on the 
same line of source code. 
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You can also pass arguments to a macro. The following example is a 
macro which copies a word from data memory to program memory: 


#define copy(src,dest) \ 
AXO=DM(src); \ 
PM (dest) =AX0; 


(The backslash characters indicate that the macro definition continues on 
the next line.) If the macro is now invoked with absolute addresses for src 
and dest, it executes the copy operation using direct addressing: 


copy (0x3F,0xCQ) 


3.6 WRITING PROGRAMS 


The remainder of this chapter tells you how to write assembly language 
programs for the ADSP-2100 Family of DSP microprocessors. You can 
generate your programs with any editor that produces plain text files. Do 
not use a word processor which embeds special control codes. 


A program consists of assembly language instructions, assembler 
directives, and C preprocessor directives. This section explains everything 
you need to know about using assembler directives. 


Additional programming techniques are explained in two sections of 
Chapter 4: “Using Library Files Of Your Routines” and “Multiple Boot 
Page Systems.” 


For programming examples of various applications, consult Digital Signal 
Processing Applications Using The ADSP-2100 Family. 


3.6.1. Program Structure 
The basic unit of an ADSP-21xx program is a module. A program consists 


of one or more modules which are separately assembled and then linked 
together. 
A module is defined by two directives: 


MODULE module_name; 


ENDMOD:; 
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Each module must be contained in its own file; in other words, only one 
module is allowed per file. Each statement within the module can be an 
instruction, directive, or macro invocation. 


A semicolon terminates each statement. Program labels are placed at the 
start of a line and followed by a colon: 


startup: iI0=2; {beginning of program} 


Individual lines in the source file must be no more than 200 characters in 
length. 


3.6.2 Setting The Memory-Mapped Control Registers 

The ADSP-2101, ADSP-2105, ADSP-2111, and ADSP-21msp50 processors 
all have a set of memory-mapped control registers which configure 
various modes of processor operation. These registers are located in the 
reserved portion of internal data memory on each chip. This memory 
space is the top 1K of internal DM, addresses 0x3C00-Ox3FFF. 


Each register must be loaded in your assembly language programs by 
writing a data word to the appropriate address. The address and format of 
each control register is given in Appendix E of this manual. 


Either indirect or direct addressing can be used to access the control 
registers; however, in the interests of clarity we recommend using direct 
addressing in conjunction with symbolic names for the register addresses. 
This method, together with appropriate commenting, makes your 
programs easier to read and understand. 


Figure 3.3 on page 3-18 shows a sample subroutine module which names 
and initializes the 17 control registers of the ADSP-2101. Note that the 
assembler’s .CONST directive is used to define symbolic names for the 
register addresses. 


To set up the control registers as defined in this example, you would call 
the subroutine in your program with the following instruction: 


CALL 1nit2101; 


Table 3.3 shows the ADSP-2101’s set of memory-mapped registers, the 
register addresses in data memory, and a suggested mnemonic symbol for 
each. Tables 3.4, 3.5, and 3.6 provide similar information for the remaining 
ADSP-21xx processors. 


Suggested Assembly 


Register Name DM addr Code Name 

System Control Register Ox3FFF  Sys_Ctrl_Reg 

Data Memory Wait State Control Register 0x3FFE §Dm_Wait_Reg 
Timer Period Ox3FFD  Tperiod_Reg 
Timer Count Ox3FFC Tcount_Reg 

Timer Scaling Factor Ox3FFB = Tscale_Reg 
SPORTO Multichannel Receive Ox3FFA = Sport0_Rx_Words1 
Word Enable Register (32-bit) Ox3FF9 = Sport0_Rx_Words0 
SPORTO Multichannel Transmit Ox3FF8 Sport0_Tx_Words1 
Word Enable Register (32-bit) Ox3FF7 Sport0_Tx_Words0 
SPORTO Control Register Ox3FF6 SportO_Ctrl_Reg 
SPORTO Serial Clock Divide Modulus Ox3FF5 = SportO_Sclkdiv 


SPORTO Rev Frame Sync Divide Modulus 0x3FF4  Sport0_Rfsdiv 


SPORTO Autobuffer Control Register Ox3FF3 Sport0_Autobuf_Ctrl 
SPORT1 Control Register Ox3FF2  Sport1_Ctrl_Reg 
SPORT Serial Clock Divide Modulus Ox3FF1 = Sport1_Sclkdiv 


SPORTI Rev Frame Sync Divide Modulus 0x3FFO 
SPORT1 Autobuffer Control Register OxSFEF 


Sport1_Rfsdiv 
Sportl_Autobuf_Ctrl 


Table 3.3 ADSP-2101 Control Registers & Suggested Symbolic Names 


If you choose to use the suggested symbols, you need not write out the 
CONST declarations as is done in the subroutine of Figure 3.3. The 
default declarations are provided for you in four files included with the 
development software: 

Contains .CONST declarations 


Filename for symbolic addresses of: 
DEF2101.H Table 3.3 
DEF2105.H Table 3.4 
DEF2111.H Table 3.5 
DEF2150.H Table 3.6 


All you have to do is include the appropriate file in your source code with 
the assembler’s .[INCLUDE directive. For example, to use the pre-defined 
symbols for the memory-mapped registers of the ADSP-2105, place the 
following statement in your initialization module: 


. INCLUDE <DEF2105.H>; 


If the file to be included is in the current directory of your operating 
system, only the filename need be given inside brackets. If the file is in a 
different directory, however, you must give the path of this directory with 
the filename (see the section “Including Other Source Files” later in this 
chapter). 


3 Assembler 


{Set up control registers for ADSP-2101 SPORTs and Timer) 
{DM (0x3 FEF) 


. MODULE/ BOOT=0 


. CONST 
. CONST 
. CONST 
. CONST 
. CONST 
. CONST 
- CONST 
. CONST 
. CONST 
. CONST 
. CONST 
- CONST 
CONST 
- CONST 
CONST 
. CONST 
. CONST 
. ENTRY 
tn e2101 : 
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- DM(0x3FFF) 


Sport1_Rfsdiv 
Sport1_Sclkdiv 
Sportl_Ctrl_Reg 


Sport0O_Autobuf_Ctrl 


Sport0O_Rfsdiv 
Sport0_Sclkdiv 
Sport0O_Ctrl_Reg 
Sport0_Tx_Words0 
Sport0_Tx_Words1 
Sport0_Rx_Words0 
Sport0O_Rx_Words1l 
Tscale_Reg 
Tcount_Reg 
Tperiod_Reg 
Dm_Wait_Reg 
Sys_Ctrl_Reg 
init2101; 


SET UP SERIAL PORT 1 REGISTERS 
DM (Sportl1_Autobuf_Ctr1)=AxX0; 
DM (Sport1_Rfsdiv) =AX0; 

DM (Sport1_Sclkdiv) =AXx0; 

DM (Sportl1_Ctrl_Reg) =AX0; 


are initialized in 35 cycles} 


Set_Up_2101_Ctrl_Regs; 
Sporti_Autobuf_Ctrl 


=QOxX3FEF > 
=QOxRS FEO: 
=Q0x3FF1; 
=QOx3FF2; 
=Ox3FF3; 
=QOx3FF4; 
=OX3FF5: 
=Ox3FF6; 
=Qx3FF? ; 
=Ox3FFS 
=aQx3 PRS: 
=Qx3FFA; 
=QOx3F FB? 
=Ox3FFC; 
=Ox3 FFD; 
=QxSFFE: 
=Qx3FFF; 


{RFSDIV not used} 
{SCLKDIV not used} 


Figure 3.3 Initializing Control Registers Using Symbolic Addresses 


{Autobuffering disabled} 


{Ctrl reg functions disabled} 


Assembler 3 


(Seeeeesesesaeeaee= SET UP SERIAL PORT 0 REGISTERS saeecescemseaseas=} 

AX0=0; DM (Sport0_Autobuf_Ctrl1)=AX0; {Autobuffering disabled} 

Ax0=255; DM (SportO0O_Rfsdiv) =AX0; {RFSDIV=255 for 8 kHz interrupts 
from 2.048 MHz SCLK} 

AX0=2; DM (Sport0_Sclkdiv) =AX0; {SCLKDIV=2 gives 2.048 MHz SCLK 
with 12.288 MHz crystal} 

AX0=0x6B27; DM(Sport0_Ctrl_Reg) =AX0; {Multichannel disabled, 


internally-generated SCLK, 

RFS required, TFS required, 
normal frame sync width, 
internal RFS, internal TFS, 
serial data is u-law, 8-bit PCM} 


AX0=0; DM (Sport0_Tx_Words0) =AX0; {TX on TDM channels 15-00} 

AX0=0; DM (Sport0_Tx_Words1) =AX0; {TX on TDM channels 31-16} 

AX0=0; DM (Sport0_Rx_Words0O) =AX0; {RX on TDM channels 15-00} 

AX0=0; DM (Sport0_Rx_Words1) =AX0; {RX on TDM channels 31-16} 

(secaceassesessa=s SET UP TIMER REGISTERS eaneeeeoeaneeeeeae } 

AX0=0; DM (Tscale_Reg) =AX0; {timer not used} 

AX0=0; DM (Tcount_Reg) =AX0; 

AX0=0; DM (Tperiod_Reg) =AX0; 

{Seeheeeeeesaen SET UP SYSTEM AND MEMORY =eesesecose=o== } 

AX0=0 s DM (Dm_Wait_Reg) =AX0; {no DM wait states} 

AX0=0x1018; DM(Sys_Ctrl1_Reg) =AX0; {SPORTO enabled, SPORT1 disabled, 
use FI,FO,IRQO,IRQ1,SCLK instead, 
BOOT_PAGE=0, BMWAIT=3, PMWAIT=0} 

RES ¢ 

. ENDMOD; 
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Register Name 


System Control Register 

Data Memory Wait State Control Register 
Timer Period 

Timer Count 

Timer Scaling Factor 

SPORT1 Control Register 

SPORT1 Serial Clock Divide Modulus 
SPORTI Rev Frame Sync Divide Modulus 
SPORT1 Autobuffer Control Register 


DM addr 


Ox3FFF 
Ox3FFE 
Ox3FFD 
Ox3FFC 
Ox3FFB 
Ox3FF2 
Ox3FFI1 
Ox3FEO 
Ox3FEF 


Suggested Assembly 
Code Name 
Sys_Ctrl_Reg 
Dm_Wait_Reg 
Tperiod_Reg 
Tcount_Reg 
Tscale_Reg 
Sport1_Ctrl_Reg 
Sport1_Sclkdiv 
Sportl_Rfsdiv 
Sportl_Autobuf_Ctrl 


Table 3.4 ADSP-2105 Control Registers & Suggested Symbolic Names 


Register Name 


System Control Register 
Data Memory Wait State Control Register 
Timer Period 
Timer Count 
Timer Scaling Factor 
SPORTO Multichannel Receive 

Word Enable Register (32-bit) 
SPORTO Multichannel Transmit 

Word Enable Register (32-bit) 
SPORTO Control Register 
SPORTO Serial Clock Divide Modulus 
SPORTO Rev Frame Sync Divide Modulus 
SPORTO Autobuffer Control Register 
SPORT1 Control Register 
SPORT1 Serial Clock Divide Modulus 
SPORT1 Rev Frame Sync Divide Modulus 
SPORT1 Autobuffer Control Register 
HIP Interrupt Mask Register 
HIP Status Register 7 
HIP Status Register 6 
HIP Data Register 5 
HIP Data Register 4 
HIP Data Register 3 
HIP Data Register 2 
HIP Data Register 1 
HIP Data Register 0 


DM addr 


Ox3FFF 
Ox3FFE 
Ox3FFD 
Ox3FFC 
Ox3FFB 
Ox3FFA 
Ox3FF9 
Ox3FF8 
Ox3FEF7 
Ox3FF6 
Ox3FF5 
Ox3FF4 
Ox3FF3 
Ox3FF2 
Ox3FF1 
Ox3FFO 
Ox3FEF 
Ox3FE8 
Ox3FE7 
Ox3FE6 
Ox3FE5 
Ox3FE4 
Ox3FE3 
Ox3FE2 
Ox3FE1 
Ox3FEO 


Suggested Assembly 
Code Name 
Sys_Ctrl_Reg 
Dm_Wait_Reg 
Tperiod_Reg 
Tcount_Reg 
Tscale_Reg 
Sport0_Rx_Words1 
Sport0_Rx_Words0 
Sport0_Tx_Words1 
Sport0O_Tx_Words0 
Sport0_Ctrl_Reg 
Sport0_Sclkdiv 
Sport0O_Rfsdiv 
Sport0_Autobuf_Ctrl 
Sport1l_Ctrl_Reg 
Sport1_Sclkdiv 
Sport1_Rfsdiv 
Sport1_Autobuf_Ctrl 
Hmask_Reg 
HSR7_Reg 
HSR6_Reg 
HSR5_Reg 
HSR4_Reg 
HSR3_Reg 
HSR2_Reg 
HSR1_Reg 
HSRO_Reg 


Table 3.5 ADSP-2111 Control Registers & Suggested Symbolic Names 


3-20 


Register Name 
System Control Register 
Data Memory Wait State Control Register 
Timer Period 
Timer Count 
Timer Scaling Factor 
SPORTO Multichannel Receive 

Word Enable Register (32-bit) 
SPORTO Multichannel Transmit 

Word Enable Register (32-bit) 
SPORT0 Control Register 
SPORTO Serial Clock Divide Modulus 
SPORTO Rev Frame Sync Divide Modulus 
SPORTO Autobuffer Control Register 
SPORT1 Control Register 
SPORT1 Serial Clock Divide Modulus 
SPORT1 Rev Frame Sync Divide Modulus 
Analog Autobuffer/Powerdown Ctrl Reg 
Analog Control Register 
ADC Receive Data Register 
DAC Transmit Data Register 
HIP Interrupt Mask Register 
HIP Status Register 7 
HIP Status Register 6 
HIP Data Register 5 
HIP Data Register 4 
HIP Data Register 3 
HIP Data Register 2 
HIP Data Register 1 
HIP Data Register 0 


DM addr 
Ox3FFF 
Ox3FFE 
Ox3FFD 
Ox3FFC 
Ox3FFB 
Ox3FFA 
Ox3FF9 
Ox3FF8 
Ox3FEF7 
Ox3FF6 
Ox3FF5 
Ox3FF4 
Ox3FF3 
Ox3FF2 
Ox3FF1 
Ox3FFO 
Ox3FEF 
Ox3FEE 
Ox3FED 
Ox3FEC 
Ox3FE8 
Ox3FE7 
Ox3FE6 
Ox3FE5 
Ox3FE4 
Ox3FE3 
Ox3FE2 
Ox3FE1 
Ox3FEO 


Suggested Assembly 
Code Name 
Sys_Ctrl_Reg 
Dm_Wait_Reg 
Tperiod_Reg 
Tcount_Reg 
Tscale_Reg 
Sport0O_Rx_Words1 
Sport0O_Rx_Words0 
SportO_Tx_Words1 
Sport0_Tx_Words0 
Sport0O_Ctrl_Reg 
Sport0_Sclkdiv 
Sport0O_Rfsdiv 
SportO_Autobuf_Ctrl 
Sport1_Ctrl_Reg 
Sportl_Sclkdiv 
Sport1_Rfsdiv 
Codec _Autobuf_ Ctrl 
Codec_Ctrl_Reg 
Codec_Rx_ Data 
Codec Tx Data 
Hmask_Reg 
HSR7_Reg 
HSR6_Reg 
HSR5_Reg 
HSR4_Reg 
HSR3_Reg 
HSR2_Reg 
HSR1_Reg 
HSRO_Reg 


Table 3.6 ADSP-21 msp50 Control Registers & Suggested Symbolic Names 


For indirect addressing of the memory-mapped registers, an I register and 
M register are used to maintain the address of the control register. If these 
DAG (data address generator) registers are incorrectly initialized or 
mistakenly overwritten, the control registers will be incorrectly set. This 
type of bug can be difficult to detect in code. 


(Note: You may notice that some ADSP-21xx program examples given in 
this and other manuals use indirect addressing for setting control 
registers. These examples are provided to demonstrate that although 
direct addressing is recommended, indirect addressing may also be used.) 


3.7 ASSEMBLER DIRECTIVES 


Assembler directives control the assembly process. They are handled by 
the assembler’s preprocessor—unlike instructions, they do not produce 
opcodes when the source file is assembled. 


An assembler directive starts with a period and ends with a semicolon. 
Some directives take qualifiers and arguments, as shown below. Qualifiers 
immediately follow the directive and are separated by slashes; arguments 
follow the qualifiers. The general form of a directive is: 


.DIRECTIVE/ qualifier / qualifier ... argument; {comment} 
Assembler directives may only have one-line comments—the comment 
cannot be continued on the next line. If you need more space to continue a 


comment, begin a new comment field on the next line. 


3.7.1. | Program Modules (.MODULE) 


The .MODULE directive marks the beginning of a program module and 
defines the module name. Source code files may contain only one module. 


This directive has the form: 
.MODULE/qualifier/qualifier .... module_name; 


Qualifiers consist of any of the following: 


RAM or ROM memory type 

ABS=address absolute start address (do not use with STATIC) 
SEG=seg_name module placed in system builder-declared segment 
BOOT=0-7 copy of module placed on boot page(s) 

STATIC prevent overwriting of module during boot page loads 


The BOOT and STATIC qualifiers are used only for systems with boot 
memory (i.e. with all family processors except the ADSP-2100). A second 
method of placing modules on boot pages is provided by the linker’s -1 
switch; see “Placing Modules On Boot Pages” in Chapter 4. 


Memory type defaults to RAM if not specified. The ABS qualifier places 
the module’s code at a particular address in program memory, making it 
non-relocatable. This means that that the linker is forced to reserve 
memory for the module at the specified address. Modules which do not 
have the ABS qualifier are relocatable. 


The SEG qualifier locates the module in a specific memory segment which 
is declared in the system specification file. If you use both the ABS and 
SEG qualifiers, and specify an absolute address which is not in the named 
segment, you will see an error message when the linker is run. 


The BOOT qualifier is used to place a copy of the module on any number 
of boot pages. The module will be stored in boot memory until it is loaded 
and executed. You can locate copies of a module on several boot pages to 
allow its contents (code and/or data) to be accessed by the code on each 
page, for example MMODULE/BOOT=0/BOOT=1/BOOT=2. Another way 
to accomplish this is with the use of the STATIC qualifier, which preserves 
the module in program memory when boot pages are loaded (see 
“STATIC Modules” below). 


The BOOT qualifier also applies to all .VAR data variable and buffer 
declarations within a module—remember that boot memory, and 


program memory in general, can contain both code and data. 


The .ENDMOD directive marks the end of a source code module. The 
assembler stops when it reaches the .ENDMOD directive. 


Here are some examples of module declarations: 

.MODULE/SEG=fir filter_routine; 

This statement declares the relocatable module filter_routine, located in a 
memory segment named fir which is defined in the system builder-output 
.ACH file. 


. MODULE/RAM/ABS=0x0040 main_prog; 


This example declares main_prog which is to be located in program 
memory RAM at address 40 (hexadecimal). 


3.7.1.1 Bootable Modules 


A system may have up to 8 boot pages. (Note: Boot memory space does 
not exist for ADSP-2100 systems.) 


When you choose attributes for bootable modules with the RAM, ROM, 
SEG and ABS qualifiers, they apply to the memory where the code is 
located at runtime—program memory, not boot memory. Thus when 
configuring the runtime memory map of your system you should think 
only in terms of program and data memory. 


The linker determines where code and data will be located in program 
and data memory according to your segment declarations for the system 
builder and your module declarations for the assembler. The linker also 
constructs the boot pages, but you cannot directly specify where a module 
is to be placed in boot memory. 


Here is one more way to think about the difference between boot memory 
addresses and program memory addresses: the processor cannot fetch and 
execute an instruction from boot memory; an entire boot page must first 
be loaded and then the code is executed from on-chip program memory. 


If you want a module (or variable/buffer) to exist in processor memory, 
either internal or external, during the execution of a particular boot page, 
you must give it the BOOT qualifier to associate it with that page. This 
causes the linker to reserve space for the object in the time frame when the 
page is being executed. 


The linker-output map listing file (MAP) shows you the layout of your 
program in boot memory as well as the corresponding mapping of code in 
runtime program memory (after booting occurs). You can use this file to 
help understand the transfer from boot memory to runtime memory. 


For example, the following directive redeclares the module main_prog 
from above. This time the module will be stored on boot page 0 until 
runtime. 


. MODULE/RAM/ABS=0x0040/BOOT=0 main_prog; 


The RAM and ABS qualifiers of this directive apply to the processor’s 
internal program memory (assuming that MMAP=0). 


Here is an example which stores copies of a relocatable module on 
multiple boot pages: 


. MODULE/RAM/BOOT=0/BOOT=2/BOOT=3 shifter; 


(See the section “Multiple Boot Page Systems” in Chapter 4 for more 
information on using multiple boot pages.) 


3.7.1.2 STATIC Modules 


If you write a code module to be used with multiple boot pages, a 
subroutine, for example, you will want the code to remain in place as the 
different pages are booted. Giving the STATIC qualifier with the module’s 
declaration will accomplish this. (The ABS qualifier cannot be used with 
the STATIC qualifier.) 


The STATIC qualifier prevents the overwriting of a module when a boot 
page is loaded, either page 0 at reset (if MMAP=0) or pages 1-7 under 
software control. The linker assures this when it determines the placement 
of your program in memory. If a module is not declared as STATIC, it 
may be partially or completely overwritten by the contents of any boot 
page. This applies to modules in both internal and external memory. 


When the linker allocates memory to store your program, it considers nine 
independent time frames of memory: non-booted program and data 
memory and boot pages 0-7. Non-booted memory is defined as the initial 
state of PM and DM before any boot page is loaded or any code executed. 


The nine time frames are considered independent of one other unless the 
STATIC qualifier is used on a code module (or data buffer) declaration. In 
the absence of any STATIC declarations, the linker assumes that each of 
the nine frames starts with a clean slate of PM and DM and that each boot 
page has the entire memory map available when it is booted. 


Thus the code and data of boot page 0 can normally be placed anywhere 
by the linker, without regard for any pre-existing memory contents (non- 
booted values), the code and data of boot page 1 can be placed anywhere 
without regard for the page 0 values, and so on. 


3 Assembler 


The rule to follow is: 


If you have a code module or data buffer which must not be 
overwritten when a new boot page is loaded, you should use the 
STATIC qualifier in its declaration. Otherwise, the linker assumes that 
all memory is available to the new page and that it may overwrite any 
existing code/data. 


Figures 3.4 and 3.5 illustrate the effect of the STATIC qualifier. Say you 
have a subroutine named routinel located in external program memory of 
the ADSP-2101. The subroutine is called by code stored on boot page 0. 
This boot page also contains a 16-word buffer named coeffs which is 
declared in a module named bootfilter. Both routinel and coeffs are 
relocatable within a system builder-defined memory segment called 
ext_pm and are declared with the following statements: 


.MOD/SEG=ext_pm/ RAM routinel; 


.MOD/RAM/BOOT=0 bootfilter; 
. VAR/SEG=ext_pm/PM/RAM coeffs[16]; 


| ADSP-2101 Boot page 0 


Internal ome OK 
'{ program memory 


External 
program memory 


14K 


RAM 


Figure 3.4 Overwriting Of Non-Static Module 


Since routinel has not been declared as static, the linker ignores it when 
determining the location of coeffs in runtime program memory. The linker 
may therefore decide to reserve space for coeffs in a portion of memory 
which overlaps routinel. When page 0 is booted, coeffs is loaded into the 
ADSP-2101’s internal program memory from where it is copied to external 
PM (by code which you must write and include on boot page 0). Figure 
3.4 shows how coeffs can overwrite routine! in this case. 


If, however, routinel is declared as a static module, the linker will reserve 
its address space and locate coeffs elsewhere in external program memory: 


.MOD/SEG=ext_pm/RAM/STATIC routinel; 


This is shown below in Figure 3.5. 


Boot page 0 
ADSP-2101 | 


: Internal 
program memory 


External 
program memory 


Figure 3.5 Static Module Preserved 


3.7.2 Data Variables & Buffers (.VAR) 


The .VAR directive declares data buffers. A data buffer is an array of 
memory locations. A variable is declared as a single-location buffer. You 
must declare all variables and buffers before referencing them in code. If a 
buffer is initialized with the .[INIT directive, the declaration and 
initialization must occur in the same module. 


The .VAR directive has the form: 
.VAR/qualifier/ qualifier ... buffer_name[length], ... ; 


The default declaration, with no qualifiers or length specified, is a 
relocatable one-word variable in data memory RAM. A single .VAR 
directive may declare any number of buffers, separated by commas, on 
one line (up to 200 characters). 


When multiple variables and buffers are declared on the same line, the 
linker places them in contiguous memory locations. If multiple buffers are 
declared on one line and the CIRC qualifier is used, a single circular buffer 
is created—the individual buffers will be simple linear buffers only. (See 
the examples below under “More On Circular Buffers.”) 


Qualifiers consist of any of the following: 


PM or DM located in program or data memory 

RAM or ROM memory type 

ABS=address absolute start address (do not use with STATIC) 
SEG=seg_name buffer placed in system builder-declared segment 
CIRC circular buffer 

STATIC prevent overwriting of buffer during boot page loads 


(The STATIC qualifier is used only for systems with boot memory, 
including all family processors except the ADSP-2100.) 


Buffers may be located in either program memory, PM, or data memory, 
DM, with default to data memory. Memory type defaults to RAM for both 
DM and PM if not specified. The ABS qualifier places the buffer at a 
particular start address, making it non-relocatable. The SEG qualifier 
locates the buffer in a specific memory segment which has been declared 
in the system architecture file. 


The CIRC qualifier defines the buffer as circular. A buffer will be 
addressed in a linear fashion unless the CIRC attribute is applied. 


The STATIC qualifier prevents the overwriting of a buffer when a boot 
page is loaded. If you want to use a buffer with code from multiple boot 
pages, it must remain unaltered as the different pages are booted. 
Assigning the buffer the STATIC attribute will accomplish this. Static 
buffers are handled by the linker in exactly the same way as static 
modules—see the section “STATIC Modules” above for further details. 


To declare a variable, give the .VAR directive with no buffer length: 
. VAR/DM/RAM/ABS=0x000A seed; 


This statement declares a one-word variable called seed in data memory 
RAM, at address 10 (decimal). 


The following is an example of a buffer declaration: 
. VAR/PM/RAM/SEG=pmdata coefficients[10]; 


Here a linear buffer is declared in program memory RAM, which is 
relocatable within a segment called pmdata. The buffer name is coefficients 
and it consists of ten locations in program memory. The buffer length 
must be placed inside brackets: coefficients[10]. 


(In this manual’s notation brackets are typically used to indicate a 
specification which is optional. The .VAR, .INIT, and INCLUDE 
directives are the only instances of assembler syntax where brackets or 
angle brackets are required.) 


This example declares a relocatable circular buffer whose length is the 
value of the constant taps. 


CONST taps=15:; 
.VAR/DM/CIRC data_bufferl[taps]; 


3.7.2.1 More On Circular Buffers 


Circular buffers can only be located at certain boundaries in memory due 
to characteristics of the ADSP-21xx processors’ circular buffer addressing 
hardware. In general, a circular buffer must start at a base address which 
is a multiple of 2", where n is the number of bits required to represent the 
buffer length in binary notation. (Refer to the following section for a 
discussion of the special case when buffer length equals 2”.) 


The linker will handle this requirement for relocatable circular buffers. 
You must do so, however, if you explicitly choose the buffer’s base 
address with the ABS qualifier. The following information is provided to 
help you understand where you may locate your circular buffers in 
memory. 


This statement declares a circular buffer of five locations: 
~.VAR/CIRC aal[5]; 


Since three bits are needed to represent the length of aa, the linker will 
assign the buffer a base address which is a multiple of eight. The three 
least significant bits of this address are zeros. 


If multiple buffers are declared on one line and the CIRC qualifier is used, 
a single circular buffer is created—the individual buffers will be simple 
linear buffers only. The length of the composite circular buffer is the sum 
of the lengths of each individual buffer. 


For example, this declaration creates one 15-word circular buffer (depicted 
in Figure 3.6): 


-VAR/CIRC aa[5],bb[5],cc[5]; 


The base address of the circular buffer is aa; this is the symbol used to 

access the buffer in code. The address of bb is aa+5 and the address of cc is 
is aa+10. The three five-word buffers can be individually accessed as linear 
buffers. 


Since the value 15 requires four bits for binary representation, the circular 
buffer aa is located at an address which is a multiple of sixteen (four LSBs 
equal to zero). 


ssembler 


The following example uses three .VAR directives to declare three 
different circular buffers: 


VAR/CIRC aal5l; 
.VAR/CIRC bb[5]; 
sWAR/CIRC ee[S]: 


Because they are declared separately, the buffers will not be contiguous— 
see Figure 3.7. 


buffer addresses 
(least significant byte) 


buffer address 


XXxXxx000 
(least significant byte) xxxxx001 
. i 3 xxxxx01 0 
xxxx0000 aa xxx O11 
xxxx0001 XXXXxX100 
xxxx0010 
xxxx0 011. 
xxxx0100 
xxxx0101 bb 
xxxx0110 
Xxxx0111 
xxxx1000 xxxxx000 
xxxx1 001 XXxXxXxX001 
XXXxXX010 
XXxXX1010 CC xxxxx O17 
xxxx LO XXXxXX100 
XXxXx1100 Boe 
XXXX1101 e ee = 
XXXX1110 Ses 
xxxxx00 0 
soo 7 
xxxxx01 0 
xxwex01 1 
XXXXX100 
Figure 3.6 Composite Circular Buffers Figure 3.7 Individual Circular Buffers 


This example creates the structure for a sine/cosine lookup table: 
.VAR/CIRC sin[256],cos[768] ; 


A single circular buffer is defined which has a length of 1024. To access the 
buffer in code, you can initialize DAG index registers and buffer length 
registers with the following instructions: 


LO="coe : {* is the “address pointer” operator} 
LO=1024; 
LLl="sin: 
Liiel024; 


These instructions load [0 and [1 with the base addresses of cos and sin. 
The corresponding L registers are loaded with the length of the circular 
buffer to enable wraparound addressing. A circular buffer is only 
implemented when an L register is set to a non-zero value. 


Refer to the Data Transfer chapter of theADSP-2100 Family User’s Manual 
for further information on circular buffers. 


(Note: For linear (i.e. non-circular) indirect addressing, L registers must be 
set to zero. Do not assume that the processor’s L registers are 
automatically initialized or may be ignored if you are not using circular 
buffers; the I, M, L registers contain random values following reset. Your 
program must initialize the L registers corresponding to any I registers it 
uses.) 


3.7.2.2 Special Case: Circular Buffer Lengths Of 2" 

One difference exists between the ADSP-2100 and all other ADSP-21xx 
processors for circular buffer placement—when the buffer length is an 
exact power of two. In all cases, a certain number of low-order bits of the 
base address of a circular buffer must be zeros. When the buffer length is 
an exact power of 2, however, the ADSP-2100 requires one more such 
Zero. 


For example, all ADSP-21xx processors except the ADSP-2100 can have 
two eight-word circular buffers located in consecutive memory blocks. 
The ADSP-2100, however, uses memory less efficiently for circular buffer 
lengths which are a power of two and must leave an eight-word block 
between the two buffers. In other words, the base address of an 
ADSP-2100 eight-word circular buffer must be a multiple of sixteen while 
it need only be a multiple of eight for an ADSP-21xx circular buffer. 


3.7.3 Initializing Variables & Buffers (.INIT) 


The .INIT directive can be used to initialize variables and buffers in ROM. 
The initialization data is incorporated into the memory image file of your 
program by the linker; the PROM splitter translates the ROM portions of 
this file into a format suitable for an industry-standard PROM burner. 


Initialization values may be listed in the directive statement or supplied 
by an external file; the .INIT directive takes one of the following forms: 


INIT buffer_name: constant, constant, ... ; 

INIT buffer_name: ‘other_buffer or Yother_buffer, ... ; 

INIT buffer_name: <filename>; 

The “ and % operators can be used to initialize the buffer or variable with 
the base address or length of other buffer(s). Any combination of 
constants, buffer address pointers, and buffer length values may be given, 
separated by commas. 

Here are some examples: 

.INIT seed: Ox3FFF; 

This statement initializes the variable seed with a hexadecimal constant. 
.INIT seed_values: 1,2,3,5,7; 

This initializes the buffer seed_values with the listed constants. 


-INIT buffer_ptr: “input_buf; 


Here the variable buffer_ptr is initialized to point to the start of the buffer 
input_buf. 


You can initialize only part of a data buffer by giving an offset from the 
base address: 


INIT buffer_nameloffset]: 


Now the initialization value(s) will be placed starting at the address 
buffer_name + offset. 


The following statement, for example, initializes the eighth, ninth, and 
tenth elements of the buffer coeffs with the values 2, 3, and 4: 


-LNIT coeffs[7]: 2,3,4; 


The third form of the .INIT directive gives the name of a file which 
contains the initialization values. The assembler establishes a pointer to 
this file and the initialization data is incorporated when the linker is run. 


The following example causes the linker to initialize the buffer cos with the 
contents of the file cosines.dat: 


-INIT cos: <cosines.dats: 


If the initialization file is in the current directory of your operating system, 
only the filename need be given inside brackets. If the file is in a different 
directory, however, you must give the path of this directory with the 
filename. For example, if inits.dat is the initialization file for a buffer 
named samples, and is located in the DOS subdirectory 
C:\2101\filter3\, then the .[INIT directive should be given in this 
way: 


.INIT samples: <C:\2101\filter3\inits.dat> 


This allows the linker to find the file. 


Initializing from files is useful for loading buffers with data generated by 
other programs such as filter coefficients or FFT twiddle factors. Since the 
linker reads and incorporates the contents of these files, a change in the 
data only requires relinking your program; there is no need to reassemble. 


Data variables and buffers can also be initialized with seven-bit ASCII 
character codes. The following statement, for example, 


-INIT inputs: ‘ABCD*; 


initalizes the first four locations of the data buffer inputs with the ASCII 
codes for the letters A, B, C, and D. The ASCII codes are placed in the 
lower seven bits of the 16-bit data memory words or in bits 8-14 of the 24- 
bit program memory words. 


A special syntax of the .INIT directive, .INIT24, lets you store 24 bits of 
data in a program memory word, rather than the normal 16 bits. This 
allows you to access the lower 8 bits of each 24-bit program memory word 
when initializing data buffers or variables in source code. For example, 
while this statement computes a 14-bit address: 


-INIT var: “label + 10 
this statement computes a 24-bit address: 
-INIT24 var: “label + 10 


3.7.3.1 Data Initializing In System Hardware 

The linker-generated .EXE memory image file contains all of your 
program’s code and initialization data. Generating this file does not, 
however, guarantee that the code and data will be loaded into memory; 
the file merely specifies what should be present in memory for the program 
to run correctly. You must provide the means by which memory is 
actually loaded. 


Once the linker creates a memory image file for your program, there are 
two ways to accomplish initialization: 1) burn PROM memory devices for 
ROM-based buffers, and 2) write code in your program to copy 
initialization data to buffers in RAM. 


You can initialize ROM buffers by using the PROM splitter in one of two 
ways: 


e to generate files to burn PROM memory devices for off-chip program 
or data memory, or 


e to generate files to burn PROM memory devices for boot memory; 
variables and buffers in on-chip program memory will be initialized 
when booting occurs (for ADSP-21xx processors with internal and boot 
memory) 


Variables and buffers located in program or data memory RAM must be 
initialized by your program. The exception to this rule is the internal 
program memory RAM of the ADSP-2101, ADSP-2105, ADSP-2111, and 
ADSP-21msp50. This RAM space can be initialized by the booting 
operation (as described above). 


Three types of memory must be initialized in source code: 


e off-chip program memory RAM 
e off-chip data memory RAM 
e on-chip data memory RAM 


To initialize buffers in these memory spaces, you must have the data 
stored in ROM memory devices—either off-chip data, program, or boot 
memory—and include code in your program which will copy the data to 
its assigned location. An example of such a custom “loader” routine is 
shown below: 


.VAR/PM/ROM sin_init[64]; 
.VAR/DM/RAM sin_table[64]; 
INIT sin_init: <sin.dat>; 


{copy initialized buffer, sin_init, from PM ROM to DM RAM} 
MO=1; 
M4=1; 
T0=*sin_table; 
14="sin init: 
CNTR=%sin_table; 
DO sin_copy UNTIL CE; 
AXO0=PM(I4,M4); 
sin copy: DM(I0,M0O) =AX0; 


For initialization data stored in boot memory, the loader routine must 
perform the copy operation from internal program memory after booting 
occurs. 


3.7.4 Naming Ports For The Assembler (.PORT) 


The .PORT directive names a memory-mapped I/O port which has 
already been declared for the system builder (and is defined in the .ACH 
file). The port’s attributes and address in memory are specified in the 
system builder declaration and need not be repeated for the assembler. 


The .PORT directive has the form: 
-PORT port_name; 


If you need to access the port in other code modules of your program, you 
should name it with both the .PORT and .GLOBAL directives in this 


module. You should then list the port with the EXTERNAL directive in 
the other modules. (See the descriptions of .GLOBAL and .EXTERNAL 
below.) 


The linker reads information about the port from the .ACH file and 
resolves all references to it. 


3.7.5 Including Other Source Files (.INCLUDE) 

The .INCLUDE directive is used to include another source file in the file 
being assembled. The assembler opens, reads, and assembles the indicated 
file when it encounters the INCLUDE statement line. The assembled code 
is incorporated into the output .OBJ file. When the assembler reaches the 
end of the included file it returns to the original source file and continues 
processing. 


The .INCLUDE directive has the form: 
INCLUDE <filename>; 


If the file to be included is in the current directory of your operating 
system, only the filename need be given inside brackets. If the file is in a 
different directory, however, you must give the path of this directory with 
the filename (or with the ADII environment variable; see below). For 
example, if the file to be included is named newcode and is located in a PC 
subdirectory C:\2111\filters\, then the INCLUDE directive must be 
given in this way: 


~INCLUDE <C:\2111\filters\newcode>; 
This allows the assembler to find the file. 


Alternatively, you can specify the path by using the ADII environment 
variable. Setting ADII equal to the path also allows the assembler to locate 
the file. In this case you can give the filename without its path in the 
INCLUDE directive. 


Included files may in turn have .INCLUDE statements within them— 
nesting of include files is limited only by memory. Included files may not, 
however, contain C preprocessor directives (e.g. #define). To include a file 
that contains C processor directives, use the C preprocessor directive 
#include instead of .[NCLUDE. 


The .INCLUDE directive allows modular programming. For example, in 
many cases it is useful to develop a library of subroutines or macros which 
are shared between different programs. Rather than rewriting the routines 
for each program, you can incorporate the macro library into an 
assembled module using the .[NCLUDE directive. 


Example: 
. INCLUDE <macro_lib>; 


3.7.6 Macros 


Macros are created with the assembler’s .MACRO directive. Macros are 
useful for repeating frequently-used instruction sequences in your source 
code. By passing arguments to a macro, it can be employed as a general- 
purpose routine and shared by different programs. 


Macro nesting is limited only by memory availability when the assembler 
is run. Nested macros must be declared in this order: inner macro first, ..., 
outer macro last. All constants used in macros must be declared before the 
macro declarations. 


3.7.6.1 Defining Macros (.MACRO) 


A macro is defined by two directives: 


MACRO macro_name(argument, argument, ... ); 


-ENDMACRO; 


Each statement within the macro can be an instruction, directive, or 
macro invocation. The EENDMACRO directive marks the end of a macro 
definition. 


A macro is invoked with its name. To execute a macro named quickloop, 
for example, simply use the following statement in your source code: 


quickloop; macro invocation 


A macro invocation may not contain additional program statements (1.e. 
instructions, preprocessor directives, or other macro invocations) on the 
same line of source code. 


Macro arguments, which are optional, take the form: 

%n it a 8 ee 

The following example defines a macro with three arguments: 

.MACRO memory_transf(%0,%1,%2) ; 

In the macro’s code, the arguments are marked by the placeholders %1, 
%2, %3, etc. When the macro is invoked, the placeholders are replaced by 
argument values passed in the call. The correct number of arguments 


must be passed. 


When the macro is called, the arguments passed may be anything listed in 
Table 3.7 below. 


Argument Exceptions 

constant or expression none 

symbol may also be any reserved keyword except 
MACRO, ENDMACRO, CONST, INCLUDE 

“symbol “*%n" not allowed 

buffer “AI%on" not allowed 


Table 3.7 Legal Macro Arguments 


The “ and % operators may not be used with argument placeholders in 
the macro definition. However, an argument passed to the macro may use 
these operators. For example, you could invoke the macro read_data(%0) 
and point to a buffer address with the argument passed: 


read_data(*input); 


(Note: Another way to define macros is with the #define C preprocessor 
directive.) 


3.7.6.2 Local Labels In Macros (.LOCAL) 


The .LOCAL directive is given with program labels used in macros. The 
.LOCAL directive instructs the assembler to create a unique version of the 
label at each invocation of the macro. This prevents duplicate label errors 
from occurring when a macro is called more than once in a code module. 


The .LOCAL directive has the form: 

LOCAL macro_label,...; 

The assembler creates unique versions of macro_label by appending a 
number to it; this can be seen in the simulator or in the .LST file if macros 
are expanded. 


See Figure 3.8 for an example of the LOCAL directive. 
3.7.6.3 Macro Example 


Figure 3.8 shows an example of a macro declaration and invocation. The 
macro is a general purpose routine which transfers the contents of a data 
buffer from one memory space to another. 


{MACRO declaration} 


.MACRO memory_transf (%0,%1,%2,%3,%4) ; {pass five arguments} 
. LOCAL transf; 
[4=%0; {set I4 to source start address} 
T5=Si ; {set 15 to destination start address} 
M4=1; {set pointer to increment by 1} 
CNTR=%2; {set length of buffer} 
DO transf UNTIL CE; {transfer data} 
SI=%3 (14,M4); {transfer from type %3 memory} 
transf: %4(15,M4)=SI; {transfer to type %4 memory} 
. ENDMACRO; 


{MACRO invocation } 
memory_transf(*coeff_table, “buffer, buff_length, PM, DM); 


Figure 3.8 Macro Example 


Note that the reserved keywords PM and DM are passed to the macro as 
arguments. 


3.7.7. Global Data Structures (.GLOBAL) 

The .GLOBAL directive allows variables, buffers, and ports to be 
referenced outside of the module they are declared in. If you declare one 
of these structures in a code module, you must name with the .GLOBAL 
directive in order to reference it in other modules. 


The .GLOBAL directive has the form: 

‘GLOBAL internal_symbol, ... ; 

Example: 

.VAR/PM/RAM coeffs[10]; 

.GLOBAL coeffs; {make buffer visible } 


{ outside of module} 


Once the symbol is made global, other modules may reference it by 
identifying the symbol as EXTERNAL (see below). 


3.7.8 | Global Program Labels (.ENTRY) 


The .ENTRY directive allows program labels to be referenced in other 
modules. This lets you use the label for subroutine calls or inter-module 
jumps. 

The .ENTRY directive has the form: 

-ENTRY program_label, ... ; 

Example: 


.ENTRY fir start; {make label visible outside module} 


Once the label is declared as an entry point, other modules may reference 
it by identifying the label as EXTERNAL. 


3.7.9 External Symbols (.EXTERNAL) 
The .EXTERNAL directive allows a code module to reference global data 


structures (variables, buffers, and ports) and entry labels declared in other 
modules. The symbol in question must be defined as a GLOBAL or 
ENTRY symbol in the module in which it originates and must be defined 
as an EXTERNAL in all others before it can be referenced. 

This directive has the form: 

-EXTERNAL external_symbol, ... ; 


Example: 


.EXTERNAL fir start; {entry label in different module} 
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3.7.10 Assembler Constants (.CONST) 


The .CONST directive defines assembler constants. Once you declare a 
symbolic constant you may use it in place of the actual number. 


The .CONST directive has the form: 
-CONST constant_name = constant or expression, ... ; 


Only an arithmetic or logical operation on two or more integer constants 
may be given as an expression; symbols are not allowed. See “Assembler 
Expressions” in Section 3.4. 


A single .CONST directive may contain one or more constant declarations, 
separated by commas, on a single line. A list of multiple declarations may 
not be continued on the following line. 


Example: 
.CONST taps=15, taps_less_one=14; 


3.7.11. Locating Code & Data In Memory Segments (.PMSEG, .DMSEG) 
The .PMSEG and .DMSEG directives are similar to the /SEG qualifier of 
the MODULE and .VAR directives. These directives have the following 
syntax: 


-PMSEG pmseg_name; 
.DMSEG dmseg_name; 


The .PMSEG directive causes the linker to locate all of the module’s code 
and data structures in the program memory segment pmseg_name. The 
.DMSEG directive causes the linker to locate all of the module’s data 
structures in the data memory segment dmseg_name. MODULE directive 
in a source code file. The pmseg_name and dmseg_name segments must be 
previously defined in the system builder’s .ACH architecture file. 


To locate all code and data of a source module in a system-builder-defined 
memory segment, normally you must repeat the /SEG qualifier on the 
MODULE statement and on all .VAR declarations within the module. The 
PMSEG and .DMSEG directives can be used instead of the repeated /SEG 
qualifiers. These directives can also be used individually, to group data or 
code separately. 


The .PMSEG and .DMSEG directives must be placed above the .MODULE 
directive in your source code file. 


Here is an example that locates only the DM data of a module in a 
segment named Audio_Samples: 


.DMSEG Audio_Samples; 
.MODULE/RAM Sample_Input; 


.VAR/DM/RAM/CIRC sample_buffer[15]; 
.VAR/DM/RAM other_buffer[5]; 
.VAR/DM/RAM another_buffer[5]; 
.VAR/DM/RAM variablel; 


...code for SAMPLE INPUT routine... 
. ENDMOD; 


The code for the SAMPLE INPUT routine will assemble and link 
normally, and will be stored in program memory. 


3.7.12 Paged Memory Systems (.PAGE) 

The system builder’s .ADSP2101P directive creates a .ACH architecture 
file for paged memory systems. The assembler’s .PAGE directive must be 
used in all source code modules that are part of the paged memory 
system: 


PASE} 


The .PAGE directive must be placed above the .MODULE directive in 
your source code file. 


A special assembler operator, PAGE variable_name, can be used to extract 
the page number (upper address bits) of a data variable/buffer: 


AXO=PAGE array0O; {Get page number of array0O} 


This instruction determines the page number of the buffer array0 and 
loads it into AX0. Note that the PAGE operator is similar the assembler’s 
address pointer (“) and length of (%) operators. 


The code modules, data buffers, and data variables that you store in paged 
memory must be confined to their own page, and may not cross page 
boundaries. 


INITIALIZATION 
METHOD copy code/data from 
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3.8 INITIALIZING YOUR PROGRAM IN MEMORY 


The linker reads assembler-output .OBJ files and generates an .EXE 
memory image file. After you assemble and link your program, you have 
the memory image file which contains all of the program’s code and data. 
This file is essentially a snapshot of system memory prior to the start of 
execution. Simply generating this file, however, does not guarantee that 
the code and data will be initialized in memory; the file only specifies 
what should be present in memory for the program to run correctly. You 
must provide the means by which RAM and ROM memory is actually 
loaded. 


There are two ways to do this: 1) burn PROM memory devices, and 

2) write routines in your program to copy code and data to the proper 
locations in RAM. These methods are described in the following two 
sections. Figure 3.9 below shows which method may be used for each 
memory space and memory type of the ADSP-2100 Family processors. 


PROCESSOR & AVAILABLE MEMORY SPACES/TYPES 


ADSP-21xx 
(all others) 


ADSP-2100 


external PM ROM 
external DM ROM 


internal PM RAM 
(via Boot Memory PROMs) 


external PM ROM 
external DM ROM 


Burn PROM 
chips 


external PM RAM 
external DM RAM 


Write source code to 


external ROM internal DM RAM 


external PM RAM 
external DM RAM 


Write source code to copy 
code/data from internal 
PM RAM (after booting) 


Figure 3.9 How To Initialize Memory 


(The ADSP-21xx simulators automatically initialize all regions of memory, 
whether internal, external, RAM or ROM; this is done to simplify 
simulator-based debugging. However, you must remember that 
initialization is not automatic in hardware.) 


3.8.1. Using The PROM Splitter To Initialize ROM 


Once the linker creates a memory image file of your program, you can use 
the PROM splitter to accomplish initialization in one of two ways: 


e by generating files to burn PROM memory devices for off-chip 
program or data memory, or 


e by generating files to burn PROM memory devices for boot memory; 
on-chip program memory RAM will be initialized when booting 
occurs (for ADSP-21xx processors with internal and boot memory) 


The PROM splitter translates ROM portions of the .EXE file into a format 
suitable for industry-standard PROM burners. 


3.8.2 Initializing RAM In Source Code 


RAM-type system memory must be initialized by your program. The 
exception to this rule is the internal program memory RAM of the 
ADSP-2101, ADSP-2105, ADSP-2111, and ADSP-21msp50. This RAM 
space can be initialized by the booting operation (as described in 
Section 3.8.1). 


Three types of memory must be initialized in source code: 


e off-chip program memory RAM 

e off-chip data memory RAM 

e on-chip data memory RAM (for the ADSP-21xx processors named 
above) 


To initialize these memory spaces, you must have the code and data 
stored in ROM memory devices—either off-chip data, program, or boot 
memory—and include source code in your program which will copy the 
information to its assigned location. One copy loop is needed for each 
discontiguous segment of memory to be loaded. 


For initialization information stored in boot memory, the loader code 
must perform the copy operation from internal program memory after 
booting occurs. This process can be automated by means of the PROM 
splitter’s boot loader option (-loader switch). See Chapter 5 for a full 
description of this feature. 


Assembler 


3.9 LIST FILE FORMAT 
The .LST list file allows you to interpret the results of the assembly 


process. An example of a list file is shown in Figure 3.10. The 
following information is found in this file: 
addr Offset from module base address 


inst Opcode (an appended “u” indicates that the opcode 
contains an undefined field) 


source line Source file line number and code 


Four assembler directives may be used to format the .LST list file 
output. These directives are: 


.NEWPAGE inserts a page break in the printed output 
-PAGELENTH lines inserts page breaks after specified number of lines 
.LEFTMARGIN columns indents left margin specified number of columns 
INDENT columns indents source code specified number of columns 
-PAGEWIDTH columns sets right margin to specified number of columns 


The .NEWPAGE and .PAGELENGTH directives can be used to paginate 
the output in a logical fashion, while .LEFTMARGIN, .INDENT and 
.PAGEWIDTH are used to make each page more readable. These 
directives may be placed anywhere in your source code file. 


Analog Devices Inc. 
C:\2101_System\fir2101.app 
source line 


addr 


0000 
0001 
0002 
0003 


0004 
0005 


0006 
0007 
0008 
0009 


inst 


3COO0ES5 
0D0388 
680080 
E89800 


14000Eu 
E80000 


20400F 
050000 
ODOCIC 
OAOOI1F 


NOP WN EF 


10 
ak 
ie 
13 
14 
15 
16 
La 
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. MODULE/RAM/BOOT=0 FIR_ROUTINE; { relocatable interrupt  } 


{ service routine module } 


-~CONST TAPS=15; 


-ENTRY FIR_START; 


{make label visible outside 


.EXTERNAL DATA_BUFFER, COEFFICIENT; {make global buffers 


FIR_START: 


CONVOLUTION: 


. ENDMOD; 


Figure 3.10 List File Menu 


visible 
CNTR = 14; {N-l1 passes within DO loop} 
SI = RX0O; {read from SPORTO} 


DM(10,M0) = SI; 
MR=0, MYO=PM(14,M4), MXO=DM(1I0,MO) ; 


DO CONVOLUTION UNTIL CE; 
MR=MR+MX0*MY0(SS), MYO=PM(1I4,M4), MXO=DM(1I0,MO) ; 


MR=MR+MXO0*MYO(RND); {Nth pass with rounding} 


IF MV SAT MR; {saturate if overflowed} 
TXO = Mei: {write to sport 0 transmit} 
RTI; {return from interrupt} 


Linker 


4.1 INTRODUCTION 


The ADSP-21xx linker generates an executable program by linking 
together separately-assembled modules. The linker’s primary output is a 
memory image file for the program which has the filename extension 
-EXE. This file is loaded into the ADSP-21xx simulators and emulators for 
debugging. Once the program is fully debugged, the PROM splitter tool is 
used to generate PROM burner files from the memory image file. 


As described in the previous chapter, the assembler processes each source 
code module and outputs an object file (OBJ), a code file (CDE), and an 
initialization file (.INT). The object file contains memory allocation and 
symbol information, while the code file contains ADSP-21xx opcodes with 
unresolved symbols marked. The initialization file contains information 
regarding data variables and buffers. The initialization data must be 
supplied by data files named with the assembler’s .INIT directive. The 
linker reads data from these files and incorporates it into the .EXE 
memory image file. Changes in initialization data only require relinking. 
Figure 4.1, on the following page, shows the files input and output by the 
linker. 


The linker scans each assembled module and resolves global/external 
symbol references between modules. It assigns (“allocates”) addresses to 
relocatable code and data fragments. The linker also reads the .ACH 
architecture description file in order to construct the system memory map 
and allocate code and data to it. You must identify your architecture file 
for the linker with the -a invocation line switch. 


The linker can generate three different files. The .EXE memory image file 
is always created—this is the executable program—and contains the 
actual opcodes and data to be stored in memory. The optional .MAP map 
listing file summarizes information regarding the linked program. The 
optional .SYM symbol table file lists all symbols encountered by the 
linker, their absolute values and their scope of reference. This file is also 
used by the ADSP-21xx simulators and emulators. 


Init Files 
(.INT) 


ecesess 0.0.8.8" 
oehceateteatehee,*. 


Object Files 
(.OBJ) 


Buffer Initialization 
Data Files [.DAT] 


Architecture 
Description 
File (ACH) 


LINKER 


Memory Image File 


(.EXE) 


Map Listing File 
(-MAP) 


Symbol Table File 
(.SYM) 


Figure 4.1 Linker I/O 


The initialization data files (:DAT) are not explicitly named in the linker 
invocation since they are specified (with the .INIT directive) in the source 
code files. The data files are incorporated by the linker. When changes are 
made in the data files, simply relink to incorporate the new data. 


(Note: Since the assembler’s .VAR directive is used for declaring both 
single-word data variables and multiple-word data buffers, the term “data 
buffer” includes both variables and buffers.) 


4.2 RUNNING THE LINKER 


The linker is invoked this way, listing the files to be processed: 
LD21 filel [file2 ...] [-switch ...] 

For example: 

1d21 main subl sub2 -a archfile 


Each input file must contain only one module. If the files are not in the 
current directory of your operating system, a path must be given with 
each filename to enable the linker to find the directory where it is stored. 
The filenames must identify the assembler-output files with no extension 
(i.e. .CDE, .OBJ, .INT). The linker-output files are given the default 
filename 210X. You can rename these files by using the -e switch (see 
“Linker Switch Options” below). 


The linker can also be invoked with the -i switch, which names a separate 
file containing a list of files to link: 


LD21 -i file_all [-switch ...] 


In this case the linker reads the indirect list file file_all, which must be a 
simple text file with one path/filename per line. 


Other optional switches control various aspects of linker operation. They 
may be entered in either upper or lower-case. Multiple switches must be 
separated by at least one space. 


The linker allocates memory to modules according to the order in which 
the input files are listed. For modules which contain circular data buffer 
declarations, changing the order of input files may determine whether or 
not a program can be successfully linked in the available memory space. 
This leads to the following guideline: 


Modules containing circular buffers of different sizes should be listed 
according to descending buffer size. 


This forces the linker to allocate memory to the larger circular buffers first 
(which have greater restrictions on allowable base addresses). 


If you forget the syntax for invoking the linker, type: 
LD21 -help 


This will show you how the command must be entered and will display a 
list of the available switches. The -help switch works with all of the 
development software tools. 


If you are assembling source code generated by the ADSP-21xx C 
Compiler, the linker must be invoked with its -c switch. Refer to the 
ADSP-2100 Family C Tools Manual and ADSP-2100 Family C Runtime 
Library Manual for further information. 


4.2.1 Placing Modules On Boot Pages 


The linker provides an alternative to the assembler’s .SEG/BOOT 
directive for setting modules in boot memory pages. The linker’s indirect 
file option is employed to accomplish this. 


To have the linker place a copy of a module on one or more boot pages, 
list the module’s filename in this way in the indirect file: 


filename B hh 


The hh parameter is a two-character hex number which selects the boot 
pages to include the module. It is an 8-bit selector for pages 0-7; any bit 
which equals 1 indicates placement on that page: 


hh, = | pg? | pg6 pg pod pg3 po2 pat pgO 


For example, the following line contained in an indirect list file 
subprog B 1F 


causes the linker to place a copy of subprog on boot pages 0-4. The linker 
must be invoked with its -i switch, naming the indirect list file. Note that 
the hh selector does not need the “Ox” hexadecimal prefix. 


4.2.2 Linker Switch Options 


The linker switches are listed below in Table 4.1; some require arguments 
as shown. 


Switch Effect 

-a archfile Architecture description file archfile.ACH read by linker 

2° Runtime stack created for compiled C programs (in DM) 
-dir directory; ... Specify directories to search for library routines 

-dryrun Quick run to test for link errors (no .EXE file generated) 

-e executable Output files given filename executable (default is 210X) 

- SYM symbol table file generated 

-i file_all Files listed in indirect file file_all are linked 

-lib ADSP-21xx Runtime C Library linked (use only with -c) 

-p Assign library routines to boot pages where called 
-pmstack C stack moved to program memory (only with -c) 

-rom ROM version of Runtime C Library used (use only with -c) 
-s heap_size Create runtime C heap (use only with -c) 

-user fastlibr Search fast library file generated by LIB21 library builder utility 
-X .MAP listing file generated 


Table 4.1 Linker Switches 


The .SYM symbol table file, generated with the use of the -g switch, is 
helpful for debugging programs with the ADSP-21xx simulators. The 
simulators read program symbol definitions from this file, allowing 
variables and address labels to be easily referenced. 


4.2.2.1 Specify Architecture File (-a) 
You must identify your .ACH architecture description file for the linker 
with this switch. The filename can be given without the .ACH extension: 


LD21 file1 file2 -a archfile 


The linker requires the information found in this file in order to allocate 
the code and data of your program to the available system memory. 


4.2.2.2 Create C Runtime Stack (-c) 


The -c switch should be used when you are linking program modules 
generated by the ADSP-2100 Family C Compiler. These programs require 
the use of a runtime stack. Giving the -c switch causes two things to 
happen. First, the linker creates the label 


top_of_ram (four leading underscores) 


which is assigned to the highest available address in data memory (or 
program memory, if the -pmstack switch is given). 


Second, the linker locates and links the C runtime header, which is an 
assembly language file required by compiled C programs. The 
____top_of_ram label is used by the runtime header to locate and initialize 
the stack in processor memory. The runtime header sets up the registers 
used to control the stack and calls the main routine of the C program. The 
stack has no limit on its size; it is allowed to grow larger (toward lower 
addresses) whenever new values are pushed onto it. The ADSP-2100 
Family C Tools Manual and ADSP-2100 Family C Runtime Library Manual 
provides detailed information regarding the runtime stack. 


Different versions of the runtime header are used for each ADSP-21xx 
processor. These files, provided with the C compiler software, have 
filenames indicating which processor each is used with. You must choose 
the proper files for your system processor and rename them as 


run_hdr.OB] 
run_hdr.CDE 
run_hdr.INT 


before linking. The linker searches for files with these names. You may 
also choose to modify the .DSP assembly source file of the runtime header 
for your C program; the source files are provided to allow this. In this case 


you must edit and reassemble the runtime header module before linking. 
Refer to the “Runtime Header” section of Chapter 2 in the ADSP-2100 
Family C Tools Manual and ADSP-2100 Family C Runtime Library Manual for 
specific filenames and procedures. 


The ADIRTH environment variable is used to locate the runtime header 
file for the linker. The linker will search for this file according to the path 
specified by ADIRTH. You must set the environment variable to point to 
the directory in which the file is stored. If, for example, you left the file in 
the Release 4.0 default directory in which it was installed, the DOS 
command to set ADIRTH would be: 


SET ADIRTH=C: \ADI_DSP\LIB\ 


The final slash must be present; do not include extra spaces. (Note:This 
default directory may have a different name in future releases; be sure to 
check your release note for the exact directory name.) 


If the linker is invoked with the -c switch but cannot find the proper 
runtime header file it will issue an error message. (Note: Only required for 
Release 4.0 or earlier.) 


4.2.2.3 Search Paths For Library Routines (-dir & ADIL) 


The linker allows you to use files of frequently-used routines as libraries. 
When a program being linked calls one of the library routines, the linker 
automatically searches for and links in the appropriate file. 


You must tell the linker where to find your library files by using either the 
-dir switch or the ADIL environment variable. The linker searches the 
path/ directories specified by ADIL first, and then those named with the 
-dir switch (if necessary). 


For example, to set the ADIL environment variable to the subdirectory 
C:\DSP\LIBRARY\ ona PC, you would enter: 


SET ADIL=C: \DSP\LIBRARY \ 


If you are listing multiple DOS paths, they must be separated by 
semicolons. The final slash must be present. Do not include extra spaces. 
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In the Unix environment on a Sun workstation, the same command would 
look like this: 


setenv ADIL “/dsp/library/INCLUDE/” 
You can specify a maximum of 20 directories with ADIL. 


After searching for library routines according to ADIL, the linker searches 
the paths named with the -dir switch (if it is given). 


See the section “Using Library Files of Your Routines” below for further 
information. (Note: Only required for Release 4.0 or earlier.) 


4.2.2.4 Output Filenames (-e) 
The -e switch allows you to name the linker-output files. If this switch is 
not used, the default filenames are 210X.EXE, 210X.SYM, and 210X.MAP. 


4.2.2.5 ADSP-21xx Runtime C Library Linked (-lib) 


This switch should be given if the program being linked has been 
generated by the ADSP-2100 Family C Compiler and employs any of the 
ADSP-21xx Runtime C Library functions. This library is a set of 
ANSI-standard and digital signal processing routines intended for use in 
C programs. The -lib switch causes the linker to search the C library and 
link any functions called. 


The -lib switch is used only in conjunction with the -c switch. Refer to the 
ADSP-2100 Family C Runtime Library Manual for further information on the 
Runtime C Library. 


4.2.2.6 Copy Library Routines Onto Boot Pages (-p) 

The -p switch causes the linker to place copies of library routines on each 
boot page where they are called. This switch should be given even if the 
routine (or routines) are called only on one page. 


A convenient way to use this switch is to keep your frequently-used 
routines in files located in the current directory and use the DOS 
convention for the current directory (a period) with the -dir switch: 


LD21 filel file2 -p -dir. “.” 1s the DOS notation for the 
current directory 


Linker 


Now the linker will find all calls to these routines in your boot pages and 
attach the appropriate code to each. 


(Note: The linker will not automatically search the current directory. If 
this is where you store your library files you must use the -dir switch or 
ADIL to point to it.) 


The -p switch may only be used for systems with boot memory— 
including all ADSP-21xx processors except the ADSP-2100. 


4.2.2.7 C Runtime Stack In PM (-pmstack) 


The -c switch causes the linker to implement a runtime stack in data 
memory for a program generated with the ADSP-21xx C Compiler. Giving 
the -pmstack switch moves the stack to program memory. 


If your program was compiled with the C compiler’s -pmstack switch, it 
must be linked with the linker’s -pmstack switch. The -pmstack switch 
may only be used in conjunction with the -c switch. (Note: Only allowed 
for Release 4.0 or earlier.) 


4.2.2.8 ROM Version Of ADSP-21xx Runtime C Library (-rom) 

The functions of the ADSP-21xx Runtime C Library may be located in 
ROM or RAM by the linker, with default to RAM. If the C Compiler’s 
-crom switch has been used to locate code modules and library functions 
in ROM, the linker must be invoked with its -rom switch. 


The -rom switch is used only in conjunction with the -c switch. 
(Note: Only allowed for Release 4.0 or earlier.) 


4.2.2.9 Create Runtime C Heap (-s) 


The -s heap_size switch causes the linker to implement a runtime heap for a 
program generated with the ADSP-21xx C Compiler. The -s switch may 
only be used in conjunction with the -c switch, which causes the creation 
of a runtime stack. The heap_size argument, which must be given as an 
integer, is evaluated by the linker in units of memory words. 


You must use the -s switch to create a heap when employing the malloc, 
calloc, or free routines of the ADSP-21xx Runtime C Library. These routines 
provide runtime memory management via the heap. 


Normally the top of the stack is located at the highest available address in 
data memory (or program memory, if the -pmstack switch is given) and 
grows downward, toward lower addresses. When the -s heap_size switch 
is given, a heap is created at the highest available address in memory. The 
stack is shifted down, and starts just below the bottom of the heap (as 
defined by the heap_size parameter you have specified). 


When the -s switch is given, the linker creates the artificial symbol 
___top_of_stack (four leading underscores) 
which is assigned the following address: 
___top_of_stack=____top_of_ram - heap_size 


This symbol is used by the runtime header to define and maintain the 
stack. (Note: Only allowed for Release 4.0 or earlier.) 


4,2.2.10 Fast Library File Searched (-user) 

The -user switch names a fast library file which you have generated with 
the LIB21 library builder utility. When this switch is given the linker will 
search only the indicated file for library routines to link. See “Building a 
Single Library for Fast Access” below. 


4.3 HOW THE LINKER WORKS 


The succeeding text explains how the linker functions when it processes 
your code modules. By better understanding how the linker makes 
decisions you can structure your program for more efficient use of 
memory. 


The job of the linker is to combine assembled code modules and 
initialization data into an executable program called a memory image file 
(.EXE). The two primary tasks are allocation of memory and resolution of 
symbols. 


4.3.1. Memory Allocation 

The linker reads each code module and data variable/ buffer declaration 
for the characteristics of the memory in which it is to be stored—RAM or 
ROM, PM or DM, segment name, etc. The linker also reads the contents of 
the .ACH architecture description file to see what memory spaces and 
characteristics are available. 


The linker assimilates all of this information and places each module, 
buffer, and variable in the correct type of memory. If an object has an 
absolute address specified with the ABS qualifier, it is called non- 
relocatable. If no absolute address is given for an object, it is relocatable. 
The linker must assign address space to each relocatable item. 


When the segment name qualifier (SEG) is combined with an ABS 
specification, the declared object is again non-relocatable. If the SEG 
qualifier is used without an absolute address, however, the declared object 
is relocatable within the named segment only. 


The linker places objects in memory in the following sequence: 


1. Non-relocatable objects—data buffers and modules with the ABS 
qualifier 


2. Circular buffers relocatable within a segment—data buffers with 
the CIRC and SEG qualifiers 


3. Modules & non-circular buffers relocatable within a segment— 
modules and data buffers with the SEG qualifier 


4. Relocatable circular buffers—data buffers with the CIRC modifier 


5. Relocatable modules & non-circular buffers—all remaining 
modules and non-circular buffers 


For ADSP-21xx processors with on-chip and boot memory, the linker will 
place as much bootable code and data as possible in the on-chip address 
space before using external memory. 


Circular buffers can only be located at certain boundaries in memory due 
to characteristics of the ADSP-21xx processors’ circular buffer addressing 
hardware. In general, a circular buffer must start at a base address which 
is a multiple of 2", where n is the number of bits required to represent the 
buffer length in binary notation. 


The linker places circular buffers in memory according to this restraint. If 
a circular buffer has a length of 13, for example, it is placed at a base 
address which is a multiple of 16. 


A complete discussion of this topic is found in the two sections pertaining 
to circular buffers under “Data Variables & Buffers” in Chapter 3. 
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4.3.1.1 Boot Memory Allocation 

A system may have up to 8 boot pages. A single boot page can store up to 
2048 24-bit program memory words for the ADSP-2101, ADSP-2111, and 
ADSP-21Imsp50. ADSP-2105 and ADSP-2115 boot pages store up to 1024 
words. 


The important concept to keep in mind for a booting system is the 
distinction between what happens when linking and what happens at 
runtime. Any code module declared with the BOOT qualifier is placed in 
the boot memory space by the linker. This placement, however, is only for 
program storage prior to runtime (when the page is booted and executed). 


The linker must also allocate address space for a bootable module’s 
code/data in program or data memory, where it is located at runtime. 
Thus the linker allocates space in both boot memory and program/data 
memory for all bootable modules. By doing so, the linker provides the 
logical interfacing of boot storage to runtime memory. 


If you want a non-booted routine or data buffer to exist in processor 
memory (either internal or external) during the execution of a particular 
boot page, you must use the BOOT module qualifier to associate it with 
that page. This, together with the STATIC qualifier, causes the linker to 
reserve space for the object during the time frame when the page is 
executed. 


The linker-output map listing file (MAP) shows you the layout of your 
program in boot memory as well as the corresponding mapping of code in 
runtime program memory (after booting occurs). You can use this file to 
help understand the transfer from boot memory to runtime memory. 


You cannot specify where a module will be placed in boot memory—the 
linker controls this function, constructing efficiently-packed boot pages. 


(Note: All ADSP-21xx processors except the ADSP-2100 have boot 
memory.) 


4.3.2 | Symbol Resolution 

To resolve program symbols, the linker must equate each symbol to a 
specific address in memory. Program labels and variable/buffer names 
are the symbols you define in your source code. The assembler simply 
passes these on to the linker, which must determine the address of each 
after placing all modules in memory. 


A symbol can only be referenced within the module where it is defined 
unless it is given the ENTRY or GLOBAL attribute. These assembler 
directives expand the scope of reference of a symbol beyond the local 
module. Other modules must declare the symbol as EXTERNAL before 
referencing it. 


For each EXTERNAL reference in a module, the linker searches all other 
modules for ENTRY or GLOBAL definitions of the symbols. An error is 
flagged if the search detects multiple matches. If the search fails, the linker 
conducts a library file search according to the sequence outlined in 
“Library Search Sequence,” above. This search traverses the directories 
pointed to by the ADIL environment variable, as well as any named with 
the library switches (-user, -dir). 


If the unresolved symbols are not found by the library search, the linker 
issues an error message. 


Once the allocation of memory is complete and all external references 
resolved, the linker assigns an address value to each symbol. 


The linker generates a SYM symbol table file (if the -g switch is given) 
which contains a list of all program symbols encountered and their 
resolved addresses. This file shows you which symbols may be referenced 
by each module. 


Appendix B describes the format of the SYM file. The SYM file is used by 
the ADSP-21xx simulators and emulators to allow symbolic references 
during debugging. 


4.4 USING LIBRARY FILES OF YOUR ROUTINES 


The ADSP-21xx linker lets you use library files of your frequently-used 
routines and subroutines. The library routines are made available to any 
program being linked. By simply referencing a routine in code you cause 
the linker to search for and link in the appropriate library file. 


You must take the following steps to prepare your libraries: 
What You Do 


1. Write the library routines, placing a label at the start of each one. 
Declare these labels as global ENTRY points (with the assembler’s 
-ENTRY directive). 


2. Declare the start label of a library routine as EXTERNAL in any 
module of your program which calls or jumps to the routine. Use 
the .EXTERNAL directive. 


3. Assemble the library routines in one or more modules (one module 
per file). 


4. Tell the linker where to find your library files. The path/ directory 
of each file must be specified with the ADIL environment variable 
or the -dir switch. 


Now when you link a program which uses any of your library routines, 
the linker does the following: 


What The Linker Does 


1. Allocates the program to memory, collects all symbols in the 
program, and attempts to determine the address for each label 
referenced. (This is known as “symbol resolution,” described 
earlier in this chapter.) 


2. Since the library routine labels are unresolved symbols, the linker 
automatically opens and searches every .OBJ file found in the 
directories specified by ADIL and -dir. All labels defined as global 
ENTRY points are examined. (Note: The file and module names 
are irrelevant in the search process.) 


3. Any file containing a label referenced by the program is included 
in the linkage. 


Linker 


When searching through your library directories, the linker first goes to 
the directories specified by ADIL and then those named with the -dir 
switch (if necessary). 


For ADSP-21xx systems with multiple boot pages, the linker’s -p switch 
should be given if any library routines are used. This switch causes the 
linker to place copies of the routines on all pages necessary. 


4.4.1 Building A Single Library For Fast Access 

The ADSP-21xx development software includes a library builder utility 
program called LIB21 which allows you to write a set of library routines 
and pack them into one file for fast access. Once the library file is 
generated, invoking the linker with the -user fastlibr switch causes it to 
search the file fastlibr, extracting and linking only the routines needed. 


Using the LIB21 utility and -user switch accomplishes the same thing as 
the -dir switch or ADIL environment variable—your library routines are 
linked with the executable program. The advantage of LIB21 is that the 
linker runs faster, since it can search a single file faster than searching 
through several. LIB21 makes this possible because it can include multiple 
modules in one file, whereas the assembler and linker normally allow only 
one per file. 


The LIB21 utility is invoked in one of two ways: 


LIB21 fastlibr file1 |file2 ...] |-v version] 
or 
LIB21 fastlibr_ -i file_all |-v version] 


The output file FASTLIBR.A is created by LIB21. This file combines the 
individually-assembled modules named on the command line (file1, file2, 
etc.) if the first form is used. These inputs should be listed with no 
filename extension (i.e. .OBJ, .CDE, .INT). 


The -i switch has the same effect here as in the linker invocation. The 
file_all file is read for a list of files to place in the output. The list must be a 
simple text file with one path/filename per line. 


The -v switch allows you to imbed a version number for the routines in 
the library module; version must be a simple character string. The version 
string does not affect code execution. 


o 
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4 Linker 


To locate the fast library file, the linker first searches the current directory 
and then, if necessary, those specified by the ADIL environment variable. 


Here is an example of how to generate a fast library file: 
LIB21 filter taps coeffs start_input -v V1.0 


LIB21 builds the file FILTER.A, combining the three input modules. The 
character string “V1.0” is embedded in the file. If the linker is now 
invoked with 


LD21 main sum graph -user filter 


the modules main, sum, and graph are linked. Assuming that one or more 
library routines from FILTER.A are called, the linker extracts each one 
required and includes them in the linkage. 


4.4.2 Library Search Sequence 

There are several ways to use library routines in conjunction with the 
linker: the -dir switch, ADIL environment variable, LIB21 utility and 
-user switch, and -lib switch. When various combinations of these 
methods are employed, the linker will conduct its search in the following 
order: 


1. Ifthe -user switch is given, the fastlibr file is opened and searched. 
Directories searched to find this file are: 


a. current directory first, then 
b. ADIL directories (if necessary) 


2. If the -lib switch is given, the ADSP-21xx Runtime C Library is 
searched. ADIL directories are searched to find the library. (See the 
ADSP-2100 Family C Tools Manual and ADSP-2100 Family C 
Runtime Library Manual.) 


3. ADIL directories are searched for remaining unresolved 
references. 


4. If the -dir switch is given, the directories listed as switch 
arguments are searched last. 


Note that for library files other than those generated by the LIB21 utility 
(Step 1 above), the linker will not search the current directory unless 
specifically instructed to by ADIL or -dir. 
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4.5 MULTIPLE BOOT PAGE SYSTEMS 


Implementing multiple boot page systems can be straightforward or 
complex, depending on how much code and data is to be shared between 
pages. If each page is completely independent, containing all information 
it needs, memory allocation by the linker is a relatively simple function. 
(Note: All ADSP-21xx processors except the ADSP-2100 have boot 
memory.) 


Many systems, however, must share code or data structures between boot 
pages. Standard linker operation does not allow this, since the linker 
wipes out the pre-existing memory map for each boot page. To prevent 
this, you must use one of the following techniques: 


e repeating the assembler’s BOOT qualifier on a module (containing 
code and/or data structures), listing each page on which it is required 


e giving the linker’s -p switch to copy library routines to each page 
necessary 


e using the assembler’s STATIC qualifier to preserve a module or data 
buffer /variable in memory as new pages are booted 


These techniques can be used individually or in combination to achieve 
various results. The first two techniques have the same end result, but the 
STATIC qualifier is a completely different mechanism. Applying this 
qualifier prevents the overwriting of a module (or buffer) when a boot 
page is loaded, either page 0 at reset (if MMAP=0) or pages 1-7 under 
software control. This applies to modules/buffers in both internal and 
external processor memory. 


When the linker allocates memory to store your program, it considers nine 
independent time frames of memory: non-booted program and data 
memory and boot pages 0-7. Non-booted memory is defined as the initial 
state of PM and DM before any boot page is loaded or any code executed. 


The nine time frames are considered completely independent of one other 
unless the STATIC qualifier is used on a code module (or data buffer) 
declaration. In the absence of any STATIC declarations, the linker assumes 
that each of the nine frames starts with a clean slate of PM and DM and 
that each boot page has the entire memory map available when it is 
booted. 
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4.5.1. | Rebooting Under Program Control 

Booting a new page during program execution is described in the Memory 
Interface chapter of the ADSP-2100 Family User’s Manual. Execution 
branches from one page to another as software-forced reboots occur. 
Rebooting is controlled by the System Control Register, the ADSP-21xx 
memory-mapped register located at address 0x3FFF in internal data 
memory. This register contains the BFORCE (boot force) bit and the 
BPAGE (boot page select) field. 


Programs implemented in multiple boot pages execute in the following 
way: 


1. Page 0 is booted and executed at system reset. 


2. When a new page is to be booted, the BPAGE select bits are set by an 
instruction of the page 0 code. 


3. With the next page selected, the reboot is initiated by setting the 
BFORCE bit. Internal program memory is loaded from the new 
page; internal data memory is unchanged. 


4.5.2 Example: Sharing A STATIC Buffer 


This section presents an example of sharing a data buffer among several 
boot pages. The same method could be used to share a subroutine, 
allowing it to be called by code from different pages. This example uses 
2K-size boot pages, which are realizable for the ADSP-2101, ADSP-2111, 
and ADSP-21msp50. 


The STATIC qualifier is used in this example to prevent overwriting of the 
buffer as software-forced reboots occur. Boot pages zero, one, and two are 
to share the buffer; the code booted from each of these pages accesses the 
data. The buffer is declared in source code stored on boot page 0: 


. VAR/ PM/RAM/STATIC dat1[64]; 
.GLOBAL datl1; 
.INIT datl: <frames.dat>; 


The buffer is named dat1, is 64 words long, and is defined as GLOBAL to 
make it visible outside of the module it is declared in. Other modules 
must define datl as EXTERNAL in order to reference it; this includes 
modules on any of the three boot pages. 


The linker reads 64 data values from the file frames.dat to initialize dat1 
with. The data is included in the boot memory portion of the .EXE 


memory image file. This file is translated by the PROM splitter into a file 
used to burn boot PROM chips. 


Figure 4.2 shows the memory images of boot pages zero, one, and two. 
Notice that the linker places the STATIC object dat1 at the top of page 
zero. The linker also reserves (at least) the 64 highest addresses of pages 
one and two for dat1. If too much code has been designated for storage on 


either of these pages and the address space of dat1 would be overlapped, 
the linker generates an error message. 


Boot Page 0 Boot Page 1 Boot Page 2 


word’ _ entire page is booted 
addresses (page length=255) 
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only page length only page length 
is booted is booted 
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Top of pages 1 & 2 

left unused by linker— 
nothing loaded from 

here during booting and 
dat? is not overwritten in 
on-chip program memory 


Initialized buffer dat? — 
initialization data included 
in boot memory image file 
and burned into boot PROM 


Figure 4.2 Boot-Loaded STATIC Data Buffer 
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This placement is what preserves the buffer in on-chip program memory, 
because only the page lengths of pages one and two are loaded. The boot 
address circuitry of ADSP-21xx processors loads on-chip program 
memory starting at the highest address used (as defined by the page 
length) and decrementing to zero. Since these pages contain less than 
(2048 - 64) words, they will not overwrite dat1 when booted. The PROM 
splitter calculates the length of each boot page and stores it in the fourth 
byte of the page (page byte address 0x0003). Because initialization data for 
dat1 is contained in the page zero image, the page length to be loaded is 
255 and the entire page is booted. The linker places OxFF filler bytes in the 
region of page zero between the end of code and dat1. 


(Note: The pagelength of a boot page is defined as: 
pagelength= (number of 24-bit PM words/§8) - 1 


Further information on this topic can be found in the “Boot Memory 
Interface” section of the Memory Interface chapter in the 
ADSP-2100 Family User’s Manual.) 


One alternative to using the STATIC qualifier to create a shared routine or 
buffer is to locate the object in memory yourself with the ABS address 
qualifier. The address must be chosen such that it is higher in memory 
than the page length of largest boot page. In this case you are doing the 
job of the linker—placing the object in memory and assuring that it is 
never overwritten during a boot page load. This requires an exact 
determination of the memory map of your entire program. For complex 
systems this may prove difficult; letting the linker to do the work for you 
is usually easier. 


4.5.3 Example: Using Static & Dynamic Segments 

This section describes a more comprehensive example of a multiple boot 
page system. We will use the ADSP-2101 as the system processor and 
create a system specification file defining static and dynamic memory 
segments. The static segment will contain code used by all boot pages, 
while the dynamic segment will contain code specific to each page. 


The system will utilize boot pages zero, one, and two. Page 0 is booted at 
reset. When pages 1 and 2 are later booted, each will partially overwrite its 
predecessor in ADSP-2101 internal program memory. The portion 
overwritten will be the “dynamic” segment and the portion preserved will 
be the “static” segment. 


Here is the system specification file (input to system builder) for this 
example: 


.SYSTEM overlay_test; 


.ADSP2101; 

.MMAPO; 

. SEG/ PM/RAM/CODE/ABS=0 dynamic[0x400]; {lower 1K of on-chip PM} 
. SEG/ PM/ RAM/CODE/DATA/ABS=0x400 fixed[0x400]; {upper 1K of on-chip PM} 
. SEG/DM/RAM/DATA/ABS=0x3 800 int_dm[0x400]; {on-chip DM} 
.SEG/BOOT=0/ROM boot0[0x800]; {boot page 0} 
.SEG/BOOT=1/ROM boot1[0x800]; {boot page 1} 
.SEG/BOOT=2/ROM boot2[0x800]; {boot page 2} 

.BNvDoYS; 


The segments named dynamic and fixed are located in internal program 
memory. All code which is common to all boot pages is placed in fixed; all 
code not common among boot pages is placed in dynamic. The segment 
size of 1024 is chosen here for simplicity only—for an actual digital signal 
processing application this segment size would be dictated by the amount 
of code common to each boot page. 


The following statements declare a set of three page-specific modules for 
each boot page: 


. MODULE/RAM/SEG=dynamic/BOOT=0 mod01; 
. MODULE/RAM/SEG=dynamic/BOOT=0 mod02; 
. MODULE/RAM/SEG=dynamic/BOOT=0 mod03; 


. MODULE/RAM/SEG=dynamic/BOOT=1 modi1l1; 
. MODULE/RAM/SEG=dynamic/BOOT=1 modi12; 
. MODULE/RAM/SEG=dynamic/BOOT=1 modil13; 


. MODULE/RAM/SEG=dynamic/BOOT=2 mod21; 
. MODULE/RAM/SEG=dynamic/BOOT=2 mod22; 
. MODULE/RAM/SEG=dynamic/BOOT=2 mod23; 


This statement declares a single module to be used by all three pages: 
. MODULE/RAM/STATIC/SEG=f1ixed/BOOT=0 common_mod; 


Finally, assume that the following buffer declaration is contained in some 
other module booted from page 0: 


. VAR/DM/RAM/STATIC/SEG=int_dm common_buf[100]; 


This data buffer stores an array of 100 values which must be accessed and 
modified by code from all three boot pages. Accordingly, the structure is 
declared as STATIC to assure that its existing state is preserved as pages 1 
and 2 are booted. The module which declares and initializes common_buf 
must include code to copy the array from internal PM to internal DM after 
it is booted. The linker only reserves space for the buffer in on-chip data 
memory; it does not provide the mechanism to get the data there. 


Figure 4.3 shows the memory images of boot pages 0, 1, and 2 after the 
program is linked. Figure 4.4, on page 4-24, shows the state of ADSP-2101 
internal memory after page 0 is booted and common_buf is copied to data 
memory. 


The boot circuitry of ADSP-21xx processors loads internal program 
memory starting at the highest address used and decrementing to zero. 
The lower addresses are loaded with every boot. Since pages 1 and 2 only 
boot code into the dynamic segment, the fixed segment is not overwritten. 
This allows common_mod to remain uncorrupted in memory. Because 
common_buf is also declared as STATIC, the linker will not overwrite the 
array with any data booted from pages 1 and 2. 


Note that while this example system uses only on-chip memory, similar 
methods must be used to implement static segments and preserve static 
objects in off-chip memory. The linker allocates off-chip storage for booted 
code and data if necessary; anything in external memory may be 
overwritten by code or data copied off-chip from newly-booted pages 
unless precautions are taken (i.e. STATIC qualification). 
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Figure 4.3 Common & Page-Specific Objects In Boot Memory 


4.6 MAP LISTING FILE 


The .MAP map listing file helps you interpret the results of linking. Using 
the linker’s -x switch generates this file. The file provides the following 
information. 


e Symbols 
A cross-referenced listing of all program symbols, arranged by module. 


The list of symbols referenced by each module is shown, with the 
following information for each symbol: 


Symbol type module name, buffer/variable name, or program label 
Address base address for modules & buffers 
Length for modules & buffers 


Memory space PM, DM, or BM 


0x0000 
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Figure 4.4 Runtime Memory State For Page 0 Code 


e Memory Segments 


ADSP-2101 


Segment names 
dynamic , fixed , & 
int_dm defined for 
PM and DM 


Array is copied 
from PM to DM 
by booted code 
executed at 
system startup 


A map of memory segments declared for the system builder and 
described in the .ACH architecture description file. The base address, 
length, and memory attributes of each segment are shown. 


Linker 


e¢ Boot Memory & Runtime Program Memory 

An address map of modules and data structures on each boot page, and 
the corresponding map of booted code in internal program memory. 
Information on boot PROM byte addresses and required PROM sizes is 
also provided. 

e Fixed vs. Dynamic Memory 

Maps of fixed program memory, dynamic data memory, and fixed data 
memory. These maps include address, length, and memory attribute 
specifications. 

e Error Messages 

See Appendix C for error message definitions. 

e Libraries 


A list of library files searched and linked. 


An example map listing file is shown in Figure 4.5. 


ADSP-21XX Linker Version 3.0 Analog Devices, Inc. 
final (final.exe) mapped according to FIR_SYSTEM (sysb2101.ach) 


xref for module: MAIN ROUTINE boot memory page(s) 0, 
MAIN ROUTINE pm 0:0000 [003B] module (global) 
DATA_BUFFER adm 0:3800 [O0O00F] variable(global) 
COEFFICIENT pm 0:0040 [O00F] variable (global) 
RESTARTER pm 0:001C label 
CLEAR _BUFFER pm 0:0024 label 
WAIT pm 0:0039 label 
FIR_START 0:004F [0000] extern (FIR_ROUTINE) 
xref for module: FIR_ROUTINE boot memory page(s) 0, 
FIR_ROUTINE pm 0:004F [000A] module (global) 
FIR_START pm 0:004F label 
CONVOLUTION pm 0:0054 label 
COEFFICIENT 0:0040 [OO0OO0F] extern (MAIN_ROUTINE) 
DATA BUFFER 0:3800 [OOO0F] extern (MAIN_ROUTINE) 


(listing continues on next page) 
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Linker 


21xx memory per FIR_SYSTEM (sysb2101.ach): 
internal 2101 pm ram mapped to 0000 - 0800 (auto booted at reset) 
internal 2101 dm ram mapped to 3800 - 3BFF 
0000 - OVFF [ 2048.] external bm rom code BOOT_MEM 


] 
0000 - OVFF [ 2048.] internal pm ram data/code INT_PM 
0800 - 3FFF [ 14336.] external pm ram data/code EXT_PM 
3800 - 3BFF [ 1024.] internal dm ram data INT_DM 
0000 - 37FF [ 14336.] external dm ram data EXT_DM 


boot memory and bootable runtime program memory map: 
boot page 0 (auto boot) 


bm: 0000-003A (x8rom:0000-00EB) pm:0000-003A [59.] 
ram module MAIN ROUTINE of MAIN ROUTINE 
bm:0040-004E (x8rom:0100-013B) pm:0040-004E [15.] 
ram circ variable COEFFICIENT of MAIN ROUTINE 

bm: 004F-0058 (x8rom:013C-0163) pm: 004F-0058 [10.] 
ram module FIR _ROUTINE of FIR_ROUTINE 


8k of boot memory rom space required for this bootable runtime map. 
Most convenient boot memory rom size is 8k bytes (64k bits). 


fixed program memory map: 


fixed program memory rom: Oi. 
fixed program memory ram: O'. 
dynamic data memory map: 
boot page 0 
3800 - 380E [15.] ram circ variable DATA_BUFFER of MAIN_ROUTINE 
fixed data memory map: 
fixed data memory rom: 0. 
fixed data memory ram: Os 
21xxlnk: final, 21xx memory use: 
program memory rom: 0.; program memory ram: 0O.; 
data memory rom: 0.; data memory ram: 0. 


Figure 4.5 Map Listing File 


PROM Splitter 


5.1 INTRODUCTION 


The PROM splitter extracts the ROM portion of the linker-output .EXE 
memory image file and formats the information for use with PROM 
programmers. 


The PROM splitter can generate files for program, data, or boot memory. 
Three files are created for program memory to organize the PROMs in 
three-byte words corresponding to the 24-bit ADSP-21xx instructions. 
Two files are created for data memory to group data into two-byte words, 
and one byte-wide files are output for boot memory. 


Byte-stream files may be created for program and data memory, for 
vertical rather than horizontal organization of words. The PROM splitter 
can generate the PROM burn files in Motorola S Record or Intel Hex 
Record format. Motorola S2 format is also supported, but only for byte- 
stream output. 


9.2 RUNNING THE PROM SPLITTER 
The command used to invoke the PROM splitter is: 


SPL21 imagefile PROMfile [-switch ...] 


Each run generates a single output file for one type of ADSP-21xx 
memory—program, data or boot. If you need to create files for more than 
one memory type, you must run the PROM splitter one time for each. 


The imagefile input is the .EXE file of your program generated by the 
linker. This file must have the .EXE extension appended by the linker; 
otherwise the PROM splitter will not recognize it. 


You must name the output PROMfile each time the PROM splitter is run. 
If you are producing files for more than one memory space (i.e. PM, DM, 
BM), different filenames should be chosen each time to avoid overwriting 
the results of the previous run. 


Five command line switches are used with the PROM splitter, one 
required and four optional: 


switch possible forms 

Memory space -pm, -dm, -bm required 

PROM file format -S, -i, -uS, -us2, -ul optional: defaults to -s 
Boot page size -bs pagesize optional: default=2K 
Boot page boundaries -bb boundary optional: default=2K 
Boot loader -loader optional 


The memory space and PROM file format switches are defined as follows: 


-pm program memory 
-dm data memory 


-bm boot memory not used in ADSP-2100 systems 
-S Motorola S record default 
-i Intel Hex record 


-us MotorolaS record byte-streaam used with -pm or -dm only 
-us2. Motorola S2 record byte-stream used with -pm or -dm only 
-ui _ Intel Hex record byte-stream used with -pm or -dm only 


The -bs, -bb, and -loader switches are described in later sections of this 
chapter. The -bs and -bb switches let you create 1K-size boot pages for the 
ADSP-2105 and ADSP-2115 processors. 


5.2.1. Example: Generating PM & DM Files 
To generate PROM burn files for program and data memory, you must 
run the PROM splitter twice: 


spl21 fir_sys pmburn —pm 
spl21 fir_sys dmburn —dm 


Here the memory image file produced by the linker is FIR_SYS.EXE, 
which contains code and data to be stored in PROMs for program and 
data memory. Note that each run’s output is given a unique filename so 
that it does not overwrite the previous result. The output files are created 
in Motorola S record format since no PROM format switch is used. 


5.2.2 Example: Generating BM Files Only 

Many ADSP-21xx systems use only boot memory for program storage, 
with no PROM-based program or data memory. For these systems, the 
PROM splitter is only run once to create the boot memory PROM file, for 
example: 


spl21 iir_sys bootburn -bm -i 


Here the -i switch is used to generate the file in Intel Hex record format. 


9.3 PROM SPLITTER OUTPUT FILES 


The PROM splitter generates three byte-wide files when the -pm switch is 
set. One file contains the upper bytes of the 24-bit words and has the 
filename extension .BNU. A second file contains the middle bytes and has 
the filename extension .BNM, and the third file contains the lower bytes 
and has the filename extension .BNL. 


The PROM splitter generates two files when the -dm switch is set. One 
file contains the upper bytes of the 16-bit data words and has the filename 
extension .BNM. The second file contains the lower bytes and has the 
filename extension .BNL. The .BNU file is created but not used. 


The PROM splitter generates one file when the -bm switch is set. This file 
includes the code and data for all pages of boot memory and has the 
filename extension .BNM. The .BNU and .BNL files are created but not 
used. 


Figure 5.1 on the next page shows the files output by the PROM splitter. 
5.3.1. Byte-Stream Output For PM & DM 


If byte-stream output is chosen with the -us, -us2, or -ui switch, a single 
file is generated (.BNM) for vertical organization of words in memory. 
This format may only be selected for program or data memory—not boot 
memory. 


The byte-stream output file is arranged with the most significant byte of 
each word preceding the less significant byte(s), from lower address to 
higher address—in other words, the high-order byte of each word is 
located at the lowest address. The 24-bit words of program memory 
require sequences of three bytes, while the 16-bit words of data memory 
require sequences of two bytes. 


Memory 
Image File 
(.EXE) 


PROM SPLITTER 


Output may be any one of: 


—ui, —us, —us2 
switches, 
byte-stream file: 


—bm switch, 
1 usable file: 


—dm switch, 
2 usable files: 


v 


—pm switch, 
3 usable files: 


Program 
Memory 


(Discard) 


(Discard) 


Output 
(.BNU) 


Program 
Memory 
Output 


(.BNM) 


(-BNU) 


Data 
Memory 
Output 
(.BNM) 


(BN) 


Program 


Memory 
or Data 
Memory 
Output 


(.BNM) 
Program 
Memory 

Output 
(-BNL) 


(Discard) — 
(BNL) 


Figure 5.1 PROM Splitter I/O 


If you have assigned any absolute addresses to memory objects, the 
information is lost in byte-stream format. 


You cannot generate byte-stream files from input which contains 
discontiguous blocks of memory (non-relocatable segments with unused 
blocks of memory in between). Your program modules must either be 
relocatable or you must place them in contiguous blocks of memory. 


5.3.2 Boot Memory Organization 

Boot memory is byte-wide and organized in vertical groups of four-byte 
words. The high-order byte of each word is located at the lowest address 
of the four-byte group. 


Each 32-bit word consists of a 24-bit instruction padded with an extra 
byte. The pad bytes (OxFF) are ignored except for the first of each boot 
page. The pad byte of the first word on a page gives the length of that 
page. The page lengths are calculated by the PROM splitter and inserted 
in the PROM image file; for page 0 this value is located at PROM byte 
address 0x0003. 


The PROM splitter calculates the length of each boot page in this way: 


Number of 24-bit instructions 
Page length = =———_—___________-_ - l 
8 


(The number of instructions must be rounded up to a multiple of eight.) 


For example, a page length of zero indicates eight words, residing in 
thirty-two sequential bytes. The maximum page length of 255 indicates 
2048 words. Refer to the ADSP-2100 Family User’s Manual for further 
information on boot memory interfacing. 


Each boot page must contain a number of words which is a multiple of 
eight—if necessary, the PROM splitter adds extra filler words 
(OxFFFFFFFF) at the end of the page to assure this. 


5.4 BOOT PAGES SMALLER THAN 2K 


The PROM splitter’s -bs pagesize and -bb boundary switches allow the 
creation of boot pages smaller than 2K. ADSP-21xx systems with boot 
memory normally load boot pages which contain 2K words. ADSP-2105 
and ADSP-2115 systems, however, require 1K-size boot pages, and you 
may also wish to use smaller page sizes in ADSP-2101, ADSP-2111, or 
ADSP-21msp50 systems. This lets you retain the benefits of multiple-page 
systems with smaller programs, while conserving circuit board space by 
using smaller boot EPROMs. 


When the PROM splitter is run for boot memory without the -bs switch, 
the default-size 2K boot pages formed can store 2048 words. By using the 
-bs switch you can create smaller boot pages; the pagesize argument may 
be any value from 0 to 2048 and must be entered in decimal: 


0 < pagesize = 2048 (default=2048) 


The -bb switch is used to make the smaller boot pages contiguous in 
memory. The boundary argument determines where consecutive boot 
pages start, and may take the following values: 


boundary=2048, 1024, 512, or 256 (default=2048) 


If pagesize=1024 and boundary=2048, for example, the 1K pages will start at 
addresses that are multiples of 2048: 0, 2048, 4096, 6144, 8192. This leaves 
an unused 1K space between each—changing boundary to 1024 eliminates 
the wasted PROM space. 


Note that the ADSP-2101, ADSP-2111 and ADSP-21msp50 simulators are 
only able to simulate the booting of 2K-size pages. If you create smaller 
boot pages, therefore, you cannot use the simulators’ LR command to load 
the boot memory PROM file and simulate booting. The L command, 
however, can always be used to load and simulate the .EXE file containing 
your executable program. (The ADSP-2101 simulator is used for ADSP- 
2105 and ADSP-2115 systems.) 


5.4.1. 1K Boot Pages For ADSP-2105, ADSP-2115 


To generate contiguous 1K-size boot pages for an ADSP-2105 or ADSP- 
2115 system, use the -bs and -bb switches with pagesize and boundary equal 
to 1024: 


spl21 imagefile promfile -bm -bs 1024 -bb 1024 


5.4.2 Boot Memory Address Line Usage 

If you use the -bs and -bb switches to generate contiguous boot pages 
smaller than 2K for an ADSP-2101, ADSP-2111, or ADSP-21msp50 system, 
or to generate boot pages smaller than 1K for an ADSP-2105 or ADSP-2115 
system, you must modify the address bus connections to boot memory in 
your system: 


pagesize disconnect from boot memory 
1024 A," 

mlz Ay A, 

256 A A 


127 117 10 


* It is not necessary to disconnect A,, in an ADSP-2105 or ADSP-2115 
system. 


These modifications allow the processor to address the smaller boot pages 
in a continuous fashion, without empty blocks of memory in between. 


For example, while normally (with 2K pages) the ADSP-2101 uses the 
following connections to address boot memory, 


e D,,, D,,, A,, select the boot page number (0-7) 
e A,,-A, select the byte address (0-8191) on each page 


by disconnecting A,, and A,, the ADSP-2101 can boot /2K-size pages 
located in contiguous memory. The D,,, D,,, A,, and A,,-A, lines then 
address the total boot memory space of 4K words (16K bytes). 


For ADSP-2105 and ADSP-2115 systems with standard 1K-size boot pages, 
address line A,, is not needed and always equals zero when accessing boot 
memory. (A,, may be necessary, however, for accessing off-chip program 
memory.) To address 1K-size boot pages, the ADSP-2105 and ADSP-2115 
use the following connections: 


e D,,, D,,, A,, select the boot page number (0-7) 
e A_.-A, select the byte address (0-4095) on each page 


Note: The -bs switch must be used for 1024 boot page size for the ADSP- 
2105 & ADSP-2115, but boot boundaries may be 1024 or 2048 -- use the -bb 
switch for 1024 boundaries. 


9.0 BOOT LOADER OPTION 


The boot loader option (-loader switch) of the PROM splitter generates a 
bootable version of your program which automatically initializes all 
necessary ADSP-21xx RAM memory spaces from internal program 
memory. Memory loading routines are added to your program to perform 
the initialization following each boot page load. 


The standard booting operation of the ADSP-2101, ADSP-2111, and 
ADSP-21msp50 loads only the processor’s internal 2K of program 
memory RAM at reset. None of the other memory spaces—internal data 
memory, external program memory, or external data memory—are 
loaded. If your bootable program requires the initialization of any of these 
memory spaces which are RAM, you must write routines to copy the 
code/data from internal PM to the necessary locations, or use the -loader 
switch. (The alternative is to use initialized ROM devices for external 
memory.) See the section “Initializing Your Program in Memory” in 
Chapter 3. 


The boot loader option also lets you create multiple-page programs which 
are completely booted at reset—the code and data is booted into internal 
PM and copied to the other memory spaces, one page at a time. 


To use the boot loader option for an ADSP-2101, ADSP-2111, or ADSP- 
21msp50 system with 2K-size boot pages, invoke the PROM splitter with 
only the -loader switch and a PROM file format switch: 


SPL21 imagefile PROMfile -loader [-s] [-i] 


To use the boot loader option for an ADSP-2105 or ADSP-2115 system 
with 1K-size boot pages, invoke the PROM splitter with the -loader 
switch, a PROM file format switch, and the -bs and -bb switches with 
pagesize and boundary set to 1024: 


SPL21 imagefile PROMfile -loader -bs 1024 -bb 1024 [-s] [-i] 


Do not use the -bm, -pm, or -dm switches—a boot memory .BNM file is 
automatically generated. The output file should be used to burn boot 
memory EPROMs. Your entire executable program is contained in this 
file, including all code and data to be copied to program and data memory 


The booting and copying process is pictured in Figure 5.2, for ADSP-2101 
2K-size boot pages. 


The -loader switch causes the PROM splitter to scan the input .EXE file for 
external PM RAM segments and internal or external DM RAM segments; 
it creates as many boot pages as necessary to store the code and data, 
regardless of how many pages are declared in the system specification file. 
In addition, small loader routines are constructed and placed at the 
beginning (low addresses) of each page. 
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Figure 5.2 Program Booting & Memory Initialization 


Figure 5.3 shows a program created with the -loader switch which is 
contained on boot pages 0, 1, and 2. The loader routines for pages 0 and 1 
include several loops, each of which copies a segment of code or data to 
the appropriate destination in PM or DM after booting. One copy loop is 
needed for each discontiguous segment. At the end of each page’s loader 
routine is a sequence of instructions which force a software boot of the 
next page. The last page, page 2, does not have a loader routine—it 
contains the first 2K page of the complete executable program. When this 
page is booted, program execution begins at address 0 in the ADSP-21xx’s 
internal PM. 


Boot Page 0 Boot Page 1 Boot Page 2 
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Figure 5.3 Boot Loader Program Example 
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The -loader switch causes the PROM splitter to assign code and data to 
each boot page (except the last) starting at the highest address and 
working down (see Figure 5.3). An unused region will usually be left in 
the middle of each page. 


After page 0 is booted, code and data segments are copied by the page 0 
loader routine to the appropriate destinations. Page 0 then forces a 
software boot of page 1, whose loader performs the same operation. 
Successive boots continue until your entire program is loaded, up to a 
maximum boot memory space of 15K. 


For the example of Figure 5.3, the following sequence of events will occur 
after system reset: 


1. Page 0 is booted into the ADSP-21xx’s internal PM. The Page 0 
loader routine is executed, copying the Page 0 code and data to 
internal DM, external PM, and/or external DM. 


2. Page 1 is booted by the Page 0 loader routine. The Page 1 loader 
routine is executed, performing the necessary copies of code and 
data. This completes the initialization process. 


3. Page 2 is booted by the Page 1 loader routine. Main program 
execution is started at address 0. 


When setting the memory-mapped System Control Register for software- 
forced boots, the loader routines set the BWAIT (Boot Wait States) field of 
this register to the default value of 3. Refer to the “Boot Memory Interface” 
section of the Memory Interface chapter in the ADSP-2100 Family User's 
Manual for further information. 


5.5.1. | How To Prepare Your Program For The Boot Loader 

If you intend to use the PROM splitter’s -loader switch to generate a 
bootable, auto-initializing version of your ADSP-21xx program, the 
following steps should be taken: 


1. Declare the maximum number of boot pages allowed, eight, in your 
system architecture file. 


2. Write your assembly modules without using the /BOOT qualifier on 
the MODULE directive. 


3. Assemble and link. 


4. Invoke the PROM splitter with the -loader switch. As the PROM 
splitter processes your program, a message is displayed indicating 
the number of boot pages created. (To save this information, use 
operating system commands to capture the text into a file.) 


When using the boot loader option you should not assign the assembler’s 
/BOOT qualifier to your program modules. This allows the PROM splitter 
to determine boot page placement for each module. 


Note that when copying code/data to external PM or DM, the loader 
routines added to your program may write to memory locations other 
than those used by the main program. For example, if the main program 
initializes locations DM[0x03FF] and DM[0x0401], and a memory-mapped 
I/O port is declared at DM[0x0400], the loader routine may write an 
undefined value to the port. You must ensure that such spurious writes do 
not cause errors in your system. One way to do this is to declare a unique 
memory segment (with the system builder’s .SEG directive) in the system 
architecture file for all of your ports. If no code or data is located in this 
segment, the ports will not be overwritten during memory initialization. 


5.5.2 Simulating A Boot Loader Program 

Since the boot loader function is implemented by the PROM splitter and 
not by the linker, you must use the PROM splitter-output .BNM file to 
simulate the bootable program. The linker-output .EXE file contains no 
boot memory information. 


To load the .BNM file into an ADSP-21xx simulator or emulator, use the 
LR (Load ROM file) command instead of the L command. The booting 
and memory initialization process can then be observed during program 
execution. 


5.6 HIP BOOT FILES (HIP SPLITTER) 


The HIP splitter is a utility program similar to the PROM splitter which 
allows the generation of files that can be loaded through the host interface 
port (HIP) of the ADSP-2111 and ADSP-21msp50. The HIP splitter is 
invoked with the following command: 


HSPL21 imagefile [addr] |-boot] [-il 


The imagefile input is the .EXE file of your program generated by the 
linker. This file must have the .EXE extension appended by the linker; 
otherwise the HIP splitter will not recognize it. The optional addr 
parameter specifies an offset from zero for the starting address of the HIP 
load file. This parameter must be entered as a hex number, without the 
“Ox” prefix. 


The output file generated by the HIP splitter is always named 
IMAGEFILE.HIP. The file format is similar to that of a .BNM file created 
for program or boot memory by the PROM splitter—the first byte booted 
into the processor’s HDR3 register contains the page length. The default 
PROM image format of the file is Motorola S Record. Using the -i switch 
generates Intel Hex format instead. 


If the HIP splitter is invoked without the -boot switch, the 
IMAGEFILE.HIP file contains 24-bit program memory words placed in 
this order: high byte, middle byte, low byte. To place the three bytes in 
the order used by the ADSP-21xx startup booting operation, high byte, 
low byte, middle byte, use the -boot switch. Loading the program 
memory words in this order may be more convenient in some systems. 
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The HIP booting operation can be simulated with the use of the HB 
command in the ADSP-2111 and ADSP-21msp50 simulators. Refer to the 
“Booting Through The Host Interface Port” section of Chapter 10, Setup & 
Debugging, for further details. 


Simulator Introduction 


6.1 OVERVIEW 


The ADSP-2100 Family Development Software is a complete set of 
software design tools. The software includes assembly and C language 
programming tools and processor simulators that facilitate DSP system 
development and debugging. The development software runs on the IBM 
(or IBM-compatible) PC and SUN4 workstation platforms. 


The software development system includes several programs: System 
Builder, Assembler, Linker, PROM Splitter, HIP Splitter, Simulators, and 
C Compiler. Chapters 6 through 13 of this manual describe the Simulators. 
For information on the System Builder, Assembler, Linker and PROM 
Splitter, and HIP Splitter, see chapters 1 through 5. For information on the 
C Compiler and Runtime C Library, see the ADSP-2100 Family C Tools 
Manual and ADSP-2100 Family C Runtime Library Manual. 


This manual is a complete reference for software simulation of the ADSP- 
2100 Family of DSP microprocessors and microcomputers. The 
microcomputer members of the family contain on-chip memory used to 
store programs and data. The ADSP-2100 Family includes the following 
processors: 


Processor Description 

ADSP-2100/2100A DSP microprocessor 

ADSP-2101 DSP microcomputer 

ADSP-2105 DSP microcomputer 

ADSP-2115 DSP microcomputer 

ADSP-2111 DSP microcomputer with host interface port (HIP) 
ADSP-2171 DSP microcomputer with host interface port (HIP) 
ADSP-21msp50/55/56 DSP microcomputer with host interface port (HIP) 


and analog interface (A/D and D/A converters) 


For information on the architecture and system interface of each 
processor, refer to the ADSP-2100 Family User’s Manual. 


duction 


Special versions of the core family members, such as the ADSP-2102 and 
ADSP-2106 mask-programmable ROM processors and ADSP-2103 3-volt 
processor, are not specifically named in text; however, these devices are 
functionally simulated in the same way as the standard components. 
Other processors added to the ADSP-2100 Family in the future will be 
fully code-compatible, allowing the use of the ADSP-21xx Simulators and 
this manual. 


In this manual, the term “ADSP-21xx” refers generically to one or all of 
the ADSP-2100 Family processors. The term “ADSP-2100” refers to both 
the ADSP-2100 and ADSP-2100A. 


Please note that any software features or text references pertaining to boot 
memory, internal or on-chip memory, are applicable to all ADSP-21xx 
processors except the ADSP-2100. This processor has no on-chip memory 
and does not use boot memory. 


6.1.1 Simulator Programs 

Several simulators support the ADSP-2100 family. They are all similar, 
differing only to reflect the individual features of the processors in the 
family. In this manual, the term “simulator” refers to the entire set of 
simulators, although some of the functions described are not available on 
all simulators. 


Four simulator programs are provided that allow simulation of any 
ADSP-21xx processor; the ADSP-2101 Simulator is used for several other 
family members: 


Simulator Used To Simulate 

Program Name These Processors 

SIM2100.EXE ADSP-2100/2100A 

SIM2101.EXE ADSP-2101, ADSP-2105, ADSP-2115 
SIM2111.EXE ADSP-2111 

SIM2150.EXE ADSP-21msp50/55/56 
SIM2171.EXE ADSP-2171 


6.1.2 Simulator Features 

The simulator is an interactive, window-oriented software tool for 
instruction-level simulation and debugging of your program. The 
simulator configures itself according to your target system architecture as 
defined in the architecture description file (ACH) generated by the 
system builder. This allows it to flag illegal operations such as reading 
from non-existent memory. Using the symbol table created by the linker, 
the simulator provides a fully symbolic environment for simulation and 
debugging. 


The simulator provides the following functions: 


Instruction-level simulation of program booting and execution 
Simulation of parallel I/O ports, serial ports, host interface port, and 
analog interface using simulated data files 
Simulation of internal and external interrupts 
Complete assembly and disassembly of the ADSP-2100 family 
instruction set 
Breakpoints and single-step execution 
Multiple break conditions including break-at-address, break-on- 
condition, break-on-expression, and break-on-address ranges 

e Full view of all processor registers and memory with the ability to 
directly modify any register’s or memory location’s contents 

e Profiling usage of portions of code during execution 


6.1.3 User Interface 

When you first start the simulator, the command window (shown in 
Figure 6.1) appears. In this window you can enter commands to use all 
features of the simulator. The simulator’s other windows are accessed 
through the various pull-down menus. 
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Figure 6.1 Command Window & Main Menu 


6.2 SIMULATOR SOFTWARE CONVENTIONS 


The simulator recognizes a different set of conventions than the other 
software development tools (assembler, linker, etc.). 


6.2.1 Case-Sensitivity 


The simulator is generally not a case-sensitive environment; uppercase 
and lowercase are used in the manual to highlight important terms, but 
commands need not be entered this way. The exception to this convention 
is that address labels are case-sensitive: “START” and “start” can be two 
different addresses. 


6.2.2 Constants 


Constants include numeric constants and symbols defined as constants. 
Symbolic constants can be used anywhere in place of numeric constants. 


6.2.3. Numeric Bases 


The numeric bases supported by the simulator are hexadecimal and 
decimal. Hexadecimal numbers are sometimes specified by a prefix. If you 
enter a number with no prefix, a default base is assumed; in most cases, 
the default is decimal, but hexadecimal is assumed in some places. 


For hexadecimal numbers, prefix a Ox (zero and x) or H#: 
Ox24FF H#CF8A 

For decimal, no prefix is needed. The number can be signed as well: 
1024 +1024 “DD 


The Ox prefix must be used to enter a number in hexadecimal when the 
default for a particular command or window is decimal. 


6.2.4 Specifying Files & Pathnames 


When the simulator requires a filename, you do not need to include the 
full pathname if the file is in: 


e the current directory of your operating system, or 
e adirectory specified in the ADI_PATH environment variable 


In all other cases, you must specify the full pathname. 


6.2.5 Specifying Addresses & Address Ranges 


An address must be one of the following: 


A symbol. Using the symbol table, the simulator determines the actual 
address specified by the symbolic reference. You must link your 
program using the linker’s -g switch to generate the symbol table. 
Address labels are case-sensitive in the simulator. The assembler 
converts all symbols to uppercase if its -c switch is not used. 


PM(addr), DM(addr), or BOOT(addr), where the addr is a symbol, 
constant, or expression. PM denotes program memory, treated as code 
or data, DM denotes data memory, and BOOT denotes boot memory. 


This form of address specification can be confusing; DM(addr) can be 
interpreted as either the address itself or the contents of that address. 
The guideline to follow is that DM(addr) is seen as an address when 
used to specify an address in a simulator command, but implies the 
data contained at that address when evaluated in an expression (see 
“Expressions” below). 


When an address must be specified in a simulator command, either the 
numeric address itself or the address label can be used. For example, if 
the label startup is equivalent to PM address 0x00A0, you could enter 
either 

> go pm(0x00A0) 

or 

> go pm(startup) 

and get the same result. 

A constant. The address space is determined implicitly. For example, 
using a constant when prompted for an address while the program 


memory window is active is understood as an address in program 
memory. 


An address range can be specified in one of two ways: 


start, end or start / length 
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where start and end are addresses as described above and length is a 
constant specifying how many memory locations are included in the 
range. In the first form, the terms must be separated by a comma; in the 
second, by a slash. 
An example of the first form is: 

pm (Qx0010) ,pm(0x0018) 
and an example of the second form is: 


pm(0x0010) /8 


6.2.6 Simulator Expressions 
The simulator can evaluate simple expressions. General expressions can 
be used in place of constants in simulator commands. 


Two kinds of general expressions are allowed: 

e an arithmetic or logical operation on two or more integer constants 
examples: 29 + 129 (128 = 48) * 3 

e¢ asymbol plus or minus an integer constant 
examples: data - 8 data_buffer + 15 

The simulator, unlike the assembler and system builder, recognizes the 


complete set of C language operators. In order of precedence, the 
operators are: 


( ) left, right parenthesis 

[~ - logical NOT, ones complement, unary minus 
* 1 % multiply, divide, modulus 
+- ° addition, subtraction 

<= >> bitwise shifts 

< > <= >= relational operators 

== [= is equal, is not equal 

& bitwise AND 

| bitwise OR 

- bitwise XOR 

&& logical AND 

| | logical OR 


Simulator 


Another feature of simulator expressions is that memory contents, such as 
data variables, and register contents can be used as operands. This is 
possible in the simulator only. The assembler cannot evaluate memory 
and register values at assembly time. 


Here are more examples of simulator expressions: 


AXO && AX1 The logical AND of the values in 
AX0 and AX1 

DM(coeff) ==0x0035 The condition that the data memory 
location at address coeff contains the 
value 0x0035 

(DM(taps + 16) *AR) - 3 The product of the value in the data 


memory location at address (taps+16) 
and the value in AR, less 3 


In addition to the processor registers such as AX0O, the simulator also 
maintains software registers that can be used in expressions. One such 
register is the cycle counter, which is displayed in the simulator’s program 
control registers window. The value of the cycle can be used in an 
expression like the following: 


CYCLE/100 


The value of the processor’s program counter (PC register) can also be 
used in expressions, for example: 


PC + 3 


6.3 MANUAL NOTATION CONVENTIONS 


Any software features or text references pertaining to boot memory, 
internal or on-chip memory, are applicable to all ADSP-2100 family 
processors except the ADSP-2100. This processor has no on-chip memory 
and does not use boot memory. 


Notation conventions used in this manual are listed below: 
e Keywords (system-reserved symbols) are shown in UPPERCASE 


characters, although they can actually be uppercase or lowercase. Both 
forms of the keyword are reserved. 
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e A lowercase word highlighted in italics, such as jumplabel, generally 
represents a user-defined symbol such as a program label, data 
variable, or filename. 


e Acaret “ represents the Control key. A caret followed by any letter, 
e.g. “W, means press and hold the Control key while typing the 
(lowercase) letter. 

e Square brackets, [ ], enclose optional items. 


e Anellipsis, ... , indicates that the preceding item(s) can be repeated. 


e A vertical bar, |, separating two or more items indicates that you 
choose one of the items. 


e The term ADSP-21xx is used generically to refer to one or all of the 
ADSP-2100 Family processors. 


e The term ADSP-2100 is used to denote both the ADSP-2100 and ADSP- 
2100A. 


e The abbreviations DM, PM, and BM, are used in text as abbreviations 
for data memory, program memory, and boot memory, respectively. 


e Since the assembler’s .VAR directive is used for declaring both single- 
word data variables and multiple-word data buffers, the term data 
buffer denotes both variables and buffers. 


Getting Started 


7.1 OVERVIEW 


This chapter tells you how to get started with the simulator. The first few 
pages describe the files that should be installed and show you how to 
invoke the simulator program. These pages also introduce the on-line help 
facility which you can access whenever you need information. This is 
especially useful when you are first starting to use the simulator. 


The remainder of this chapter is a two-part tutorial that describes step-by- 
step procedures for performing some common simulation functions. 
Follow this tutorial to gain some experience using the simulator quickly, 
without having to learn all the details of its operation. The first part of the 
tutorial covers basic functions used by everyone; the second part covers 
more complex functions that you may not need to know. 


7.2 PREPARATION 

Before starting the simulator, you need to prepare your linked program 
and install all simulator program files. The release note included with 
your shipment of software contains complete installation instructions. 


7.2.1. Simulator Files 
At the time of this writing, the processors in the ADSP-2100 family and 
the simulator programs that support them are as listed in Table 7.1. 


Simulator Used To Simulate 

Program Name These Processors 

SIM2100.EXE ADSP-2100/2100A 

SIM2101.EXE ADSP-2101, ADSP-2105, ADSP-2115 
SIM2111.EXE ADSP-2111 

SIM2150.EXE ADSP-21msp50/55/56 
SIM2171.EXE ADSP-2171 


Table 7.1 Simulator Programs 


Each simulator uses a variety of files, as shown in Figure 7.1, which can be 
found on the following page, and listed in Table 7.2. 


File Description 


Required User Files 
Executable ADSP-21xx program 
Architecture description file 


Optional User Files 
Symbol table file 
Data files for I/O 


Required Simulator Files 
Simulator program 
Help files 


Optional Simulator Startup Files 


Default windows configuration 
(processor specific) 


Simulator-Created Files 
Temporary cache storage 


Table 7.2 Simulator Files 


Filename Extension 


.EXE (output of Linker) 
.ACH (output of System Builder) 


SYM (use Linker -g switch to create) 
.DAT (optional filename extension) 


.EXE (See Table 7.1) 
.TXT (required for Help only) 


52100_x.WIN 
S2101_x.WIN 
92111_x.WIN 
S2150_x.WIN 


S14. OF 


(“x” refers to the windows version) 


2 or 6 files named CACHE# (# is a 
single digit) 


At startup, the simulator loads the default architecture description file 
(210x.ACH) and the default windows configuration file. You can also 
specify other .ACH and .WIN files to be loaded instead of the defaults (as 


described in Section 7.3). 


The first time you start the simulator, the default windows configuration 
consists only of the Command Window. When you exit the simulator 
without saving the windows configuration to a specific .WIN file, the 
default windows file (S2101_0.WIN, for example) is updated to reflect 
the final windows configuration. This configuration is loaded the next 
time you start the simulator. When you quit the simulator, the default 


windows file does not change. 


The simulator creates temporary files (in the boot directory) to store the 
contents of any boot memory of the system being simulated. These files 
are named CACHE#, where # is a single digit. The simulator normally 
purges these files upon quitting; if, however, the simulator program 
aborts prematurely, these files remain. Since they occupy a large amount 
of memory and are of no use, they can be deleted. 


Architecture 
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File (.ACH) cs Files (Optional) 


PM/DM Memory 
Image File 
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Default Display 
(.WIN) File 


Simulator State File 
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Debug Symbol Table 
File (.SYM) 
(Use Linker -g switch 
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V/O Port, SPORT & HIP 
Data Files (.DAT) 
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Figure 7.1 Files Used By The Simulator 


7.2.2 Environment Variables 


The software installation process automatically sets environment variables 
needed for proper operation of the development software, including the C 
Compiler. These variables are listed in Table 7.3. 


Name Description 
ADI_DSP Path to the directory containing the installed files 
ADI Path(s) to INCLUDE directories, used with #include 


C preprocessor directive of Assembler/C Compiler 


Table 7.3 Environment Variables 


7.3 INVOKING THE SIMULATOR 


The simulator invocation command is: 


SIM21XX __ [-a filename] |-e filename] |-k filename] [-o filename] 
[-w filename] [-c] [-help] 


where: 
SIM21XX simulator .EXE file—SIM2100, SIM2101, SIM2111, 
SIM2150, or SIM2171 
filename specific file name; the file type varies according to the 


command switch, however the file extension (.ACH, 
.EXE, .KSF, or .WIN) is not required 


The simulator program name can be uppercase or lowercase, except in 
UNIX systems in which it must be lowercase. The following command 
line, for example: 


C:> sim2101 -a myarch 


invokes the ADSP-2101 Simulator with an architecture file named 
MYARCH.ACH. 


7.3.1 | Command Line Switches 

-a filename 

To use an architecture description file other than the default 210x.ACH, 
you must list this file with the -a switch. The extension .ACH is assumed 
for this filename and need not be included. This architecture description 
file must have been used to link your program; the simulator configures 
itself according to this target architecture. 


If the processor specified in the architecture description file does not 
match the simulator program being invoked (e.g., the file contains the 
.ADSP2100 directive but the program name is SIM2101), the simulator 
displays a warning and proceeds. 


When the ADSP-21msp50 simulator (SIM2150) is invoked with an ADSP- 
21msp51 architecture file, the simulator automatically configures itself for 
the on-chip memory configuration of the ADSP-21msp51. If an ADSP- 
21msp51 is specified in the architecture description file and the 
ROMENABLE bit is set to 1, the simulator defines program memory 
locations PM(0x0800)-PM(0x1000) as ROM; otherwise, they are (external) 
RAM. The ROMENABLE bit is displayed in the simulator’s control 
registers window. 


Use the ADSP-2101 Simulator (SIM2101) to simulate an ADSP-2105 or 
ADSP-2115 system. If the architecture description file specifies an ADSP- 
2105 or ADSP-2115, the portions of internal memory in the ADSP-2101 
which do not exist in the ADSP-2105/ADSP-2115 are displayed in the 
simulator as non-existent. 


“Cc 

The -c switch makes the simulator case-sensitive for any symbols used in 
assembly code (variable/buffer names and address labels). Normally the 
simulator is case-insensitive, treating uppercase and lowercase characters 
the same; use the -c switch if you need to differentiate between the two. 
Example: loop1l Loop 1 


-e filename 

To load an executable file automatically when invoking the simulator, use 
the -e switch followed by the file name. The .EXE extension is not 
required. 


-help 
The -help switch displays the syntax of the simulator invocation command 
and the options available. The simulator is not invoked. 


-k filename 

You can load and run a keystroke file when starting the simulator with the 
-k switch. This switch only works with keystroke files that were created 
and saved during earlier simulator sessions. The simulator automatically 
assumes the .KSF extension when you use this switch, so you need not 
include it. 


-o filename 

The -o switch creates an ASCII output file that contains the messages 
displayed in the Command Output Window and the contents of all pop- 
up error windows generated during the ensuing simulator session. The 
software does not automatically append extensions to these text files. 


-w filename 

The -w switch starts the simulator with the specified windows 
configuration rather than the default configuration. If you do not use the 
-w switch, the simulator reads the windows configuration stored in the 
default file. The simulator also automatically overwrites the default 
windows file when exiting, so that the default at startup always matches 
the last windows configuration used in the last session. If the -w switch is 
not used and the default .WIN file is not found, only the command 
window will open. 


7.4 ON-LINE HELP SYSTEM 


The simulator’s help screens provide on-line assistance during a simulator 
session. Help screens are context-sensitive; they provide information that 
is relevant to what you are currently doing. You can activate the help 
screens any time the simulator’s “Running” message is not displayed. 


To activate the help system: 

Select Help from the menu bar, or press F1. 
The highlighted words in a help screen provide links to other topics. Click 
ona highlighted word (or use the arrow keys and press Return) to call up 
additional information related to that topic, or to navigate through the 


screens. 


When you're finished with the help screens, select Return To Simulator, or 
press Escape to exit the help screens and return to the simulator. 


7.9 TUTORIAL 


This section contains a two-part tutorial that shows you how to perform 
some common simulation tasks. The first part of the tutorial covers basic 
operations that are used frequently; the second part focuses on simulating 
serial port operation. The tutorial applies to all the simulator programs 
unless otherwise noted, although the information displayed in a particular 
window may be different for different processors. 


By the end of the tutorial, you will be able to: 


Use windows and commands to interact with the simulator 
Load, inspect and alter simulated memory and registers 
Control program execution 

Use files for simulated data input and output 

Simulate external inputs to the processor 


The tutorial is written for systems that have a mouse. If your system does 
not have a mouse, you can activate windows and place the cursor by 
using control-key sequences or the arrow keys. For additional information 
about the user interface, see Chapter 8, User Interface. 


7.5.1 Basic Operations 
These basic operations are described in the first part of this tutorial: 


e Window configuration—Opening and manipulating windows in the 
display. 


e Loading files—Transferring instructions and data from files to 
simulated memory. 


e Viewing memory and registers—Displaying registers and memory 
locations. 


e Starting and stopping program execution—Controlling instruction 
execution. 


e Simulating I/O ports—Using data files to represent data coming from 
or going to a memory-mapped peripheral. 


e Viewing the trace history—Using the trace capability to observe 
program execution and bus activity. 


You enter commands in the command window to perform most of these 
operations. Throughout the tutorial, the commands are listed followed by 
an abbreviated form in parenthesis, such as “load (1)”. Either form of the 
command will work. 


7.5.1.1 Example Program #1 


Before you begin this part of the tutorial, you must assemble and link the 
program shown in Listing 7.1. This example program adds two numbers 
read from buffers in memory and outputs the sum to a memory-mapped 
peripheral. The four files used in this example are supplied with the 
development software in the examplel directory. 

Generate the architecture description file using the command: 

> bld21 examplel 

The System Builder yields the file examplel.ach. 

Assemble the program using the command: 


> asm21 vectadd 


The Assembler creates the files vectadd.obj, vectadd.cde and 
vectadd.int. 


Link the files using this command: 
> 1d21 vectadd -a examplel -g -e vectadd 


The -a switch tells the Linker to use the examplel.ach architecture file. 
The -g switch causes the linker to create the symbol table along with the 
executable file so that the simulator can display labels and variable names. 
The -e switch names the output files vectadd.exe and vectadd.sym. 


Once you have generated the executable file vectadd.exe you can 
invoke the simulator, specifying examplel.ach as the architecture 
description file to tell the simulator how to configure system memory. For 
example, to invoke the ADSP-2101 simulator, enter: 


> sim2101 -a examplel 
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File: EXAMPLE1.SYS 
. SYSTEM example; 
.ADSP2101; 
. SEG/ PM/RAM/ABS=0/CODE/DATA ext_pm[2048]; 
. SEG/DM/RAM/ABS=14336/DATA int .dm[ 1024] 
. PORT /DM/ABS=0 Zz outs 
».BNDSYS } 
File: VECTADD.DSP 
. MODULE vector_add; 
. CONST Hea Ls {Set vector dimension} 
. VAR/DM/RAM x input [nn]; 
. VAR/ PM/RAM/ABS=100 y_input[n]; 
. [INIT x input: <xin.dat>; 
sLeilT y_input: <yin.dats; 
+» PORT Z_ Outs 
JUMP start; NOP; NOP; NOP; {Interrupt vector table} 
RTI; NOP; NOP; NOP; {No interrupts used} 
RTT: NOP: NOPs NOP; 
RTI; NOP; NOP; NOP; 
RTI; NOP: NOP; NOP; 
RTI; NOP; NOP; NOP; 
RTI; NOP; NOP; NOP; 
start: la=°"S 1 0puUt 
Lz=0 + 
16=“y_input ; 
L6=0; 
MO=1; LO=0; 
M5=1; L5=0;7 
CHT R=n- 1? 
AXO0=DM(I2,M0), AYO=PM(1I6,M5); {Get lst data} 
DO add_loop UNTIL CE; 
AR=AX0+AY0, AXO=DM(I2,M0), AYO=PM(1I6,M5) ; 
add_loop: DM (z_out) =AR; {Write output} 
AR=AX0+AY0/; 
DM (z_out) =AR; 
IDLE; 
. ENDMOD; 


T 
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Gettinc 


File: XIN.DAT 
0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
OOOA 


File: YIN.DAT 
OOOB 
OO0C 
O00D 
OOO0E 
OOOF 
0010 
0011 
0012 
0013 
0014 


Listing 7.1 Example Program #1: Vector Addition 


7.5.1.2 Window Configuration 

When you invoke the simulator, its windows configuration is read from 
the file S2101_x.WIN. This default file stores the windows configuration 
that was active at the end of the last simulator session. If this file is not 
found or if this is the first simulator session, the display contains only the 
command window, as shown in Figure 7.2. 


If your display looks like Figure 7.2, you can continue with the tutorial. If 
there are other open windows besides the command window, close them 
before proceeding. This section of the manual only contains basic 
information for selecting, closing, opening, moving, and resizing 
windows. For detailed explanations on manipulating windows, refer to 
Chapter 8, User Interface. 
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Figure 7.2 Command Window 


To activate and close a window: 


1. Move the cursor inside the window border, then click with the 
mouse to activate the window. An active window contains the 
cursor, and its border is a different color from the borders of other 
windows. (Pressing the F2 function key activates each window in 
turn.) 


2. Press Escape to close the window. 
Repeat this procedure until the only the command window is open. 
Example 1 uses the computational registers window, DAG registers 
window, program control registers window, and program memory 


window. You can open register windows and memory windows from the 
pull-down menus available from the main menu bar. 
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To open the register windows: 


1. With the mouse, click on Register to display the drop-down menu. 
2. From the menu, click on the desired window to open it. Repeat this 
procedure until the computational registers window, DAG registers 
window, and program control registers window are open. 
To open the program memory display window: 
1. Click on Memory to display the drop-down menu. 
2. Click on Program Memory Display to open it. 


New windows always open in the center of the screen. Usually, you must 
move them to display more than one window at a time. 


To move the windows: 


1. Position the cursor anywhere on a window border, except on a 
corner or scroll bar. 


2. Drag the window to its new location, then release the mouse button. 


Move the windows until the screen resembles Figure 7.3. If necessary, 
resize the windows. 


To resize windows: 
1. Position the cursor over the corner of a window. 


2. Press the button and drag the mouse to resize the window. When 
finished, release the button. 


7.5.1.3 Loading Files 


When you first invoke the simulator, it configures its memory space 
according to the architecture description file (examplel.ach in this 
case). The memory is uninitialized, however, until you load files. For 
example, the program memory window that you just opened shows that 
each location contains an undefined value. 
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IRAM 
IRAM 
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I RAM 
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TRAM 
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[66611] 
[6662 ] 
(4463 ] 
[H46H4 1] 
[4665 J 
[6666 ] 
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[6663 1 


CALLA 
ULULULL LLL 
CULL 
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CLULUL LAL 
CULL LLL 
CALLE 
ULULLLULLLL 
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Figure 7.3 Simulator Display With Various Windows Opened 


To load the file vectadd.exe : 


1. Activate the command window by clicking with the mouse or 


pressing F2 until the window becomes active. 


2. Enter 


= 


OF 


= = 


“vyectadd’ 


“load vectadd’ 


in the command window, then press Return. 
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The program memory window is updated as shown in Figure 7.4. Notice 
that in this window the memory contents are disassembled (shown as 
assembly language instructions). 
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UULLLLL 


active 

AX1: uuu AR: uuu 
AY1: uuu AF: uuu 
MX1:° uuu 

MY¥1: uuu MF: uuu 
MR1i: uuu MR2Z2: uu 
SR1i: uuuu 

SE: uu SB: uu 
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Program Control (Hexadecimal) 
PC: 64666 
CNTR: ULL 
CYCLE: 4666884 
PM_ADDR: uuuu 
DM_ADDR: 


Figure 7.4 Program Memory Window With Program Loaded 


7.5.1.4 Viewing Memory & Registers 


The simulator lets you view and alter registers and memory locations, 
allowing you to observe program execution and make changes for 


debugging purposes. 


To view a register, you open the window containing that register. For 
example, you open the computational registers window to view ALU, 
MAC, and shifter registers. The simulator updates register values as they 
are changed by the executing program. 


To view a memory location, you open the window containing that 
address. The memory windows are: 


e Data Memory (shows contents as numerical values) 
e Program Memory (shows contents as disassembled instructions) 
e¢ Boot Memory (shows contents as disassembled instructions) 


Each memory window can show only a portion of its memory space. 
There are several ways to bring a memory location into view, described in 
the following procedures. The program memory window is used in these 
examples, but the procedures apply to any memory window. The memory 
window must be active during these procedures. 


To scroll down (toward higher addresses) in the program memory 
window: 


1. Activate the program memory window. 


2. Press and hold the down-arrow key. When the cursor reaches the 
bottom of the window, it scrolls the next location into view. 


3. Release the down-arrow key to stop scrolling. 


Similarly, press and hold the up-arrow key to scroll up in a memory 
window. 


To shift the window’s display to show a specific address: 
1. Type “G. A pop-up window appears and prompts you for a symbol 
name or address. The symbol can be an address label or variable 


name. 


2. Type y_input and press Return. The window shifts to 0064, the 
address labeled y_input, which is the start of the y_input buffer. 


In this example, either y_input or its hexadecimal address equivalent 
(0x0064) could have been entered in the pop-up window. 


The HOME and END keys shift a memory window’s display to the 
beginning and the end, respectively, of the memory space. 


To shift the program memory window’s display to the start of program 
memory: 


1. Press the HOME key. The window shifts to address 0000. 


To shift the program memory window’s display to the end of program 
memory: 


1. Press the END key. The window shifts to address 3FFF. Notice that 
the first column shows “”- - - -”, which means that this location was 
not defined in the architecture description file. 


The Page Up and Page Down keys shift the display up or down by one 
screen. 


To shift the program memory window’s display up by one screen: 
1. Press the Page Up key. 
To shift the program memory window’s display down by one screen: 
1. Press the Page Down key. 
To track the memory locations that code reads from or writes to: 
1. Activate a memory window. 
2. Type “O to enable (or disable) address tracking. 


When you enable this feature, the address of the memory location that is 
read from or written to is centered in the memory window. This command 
only works for hexadecimal, decimal, and fixed-point window data 
formats. 


7.5.1.5 Starting & Stopping Program Execution 

There are a number of ways to control simulated program execution. The 
single-step operation executes one instruction and then halts, updating 
any register or memory values that have changed. 


The current value of the program counter (PC) is shown in the program 
memory display (the address is highlighted). The PC is also displayed in 
the program control registers window. Initially, the program counter 
contains 0000. A single step causes the simulator to execute the instruction 
at address 0. 
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To single step: 


1. Activate the command window. 


2. Enter 


> Step 


OT 


- 8 


in the command window. 


Because the instruction at address 0000 is a jump to the label START, the 
PC moves to location 001C, the address of START, in the program 
memory window. The value of the PC is also updated in the program 
control window, as shown in Figure 7.5. 


BFile Register 


DAG Regi 
> ULLLLLL 
> ULLLLUL 
> UNLULU 
> ULL 
> ULLULU 
> ULULLLUL 
> ULLULU 


(4H1ic] 
(461id] 
[461e] 
(H61f J 
[46626] 
[46211 
[44622 ] 
[4623] 


Memory Stacks 


sters (Hexadecimal) 


> ULLLLLLL 
> ULL 
> UUULLLLL 
> ULL 
> ULL 
> ULL 
> ULL 


UUWULL L6: 


4x3864 
6x4HH4 
4x64 
4x4H84 
4x46661 
4x6466 
4x6HH1 
4x66 


LALLLLLL 


> ULLLULUL 
> ULLLLLUL 
> ULL 
> LULU 
> UULLLUL 
> LULL 
> UUULL 


Command Execution 


Display Misc Help Quit 


Computational Registers (Hexadecimal) 


> ULLLULLL 
> ULLLULLL 
> ULL 
> UULLLLLL 
> ULL 
> UULLULUL 

LULLLULL 


Figure 7.5 Program Memory Window At START Label 


> ULLLULUL 
> UUULLLLL 
: ULL 
> ULLLULLL 
> ULL 
> UU 
UU 


DM ADDR: 


AR: uuu 
AF: wuuu 


MF: uuu 
MR2Z2: uu 


SB: uu 


HHic 
LULL 
HHHH6HH5 


: ULL 
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The eight instructions beginning at START are initializations of DAG 
(data address generator) registers. You can execute these instructions and 
see the resulting changes in the DAG registers window. 


To single step 8 times: 


1. Enter 
> step 8 
or 
> s 8 


in the command window. 


You should see values written to I[2, 16, MO, M5, LO, L2, L5 and L6 in the 
DAG registers window as a result. Also, the program memory window 
changes to show the new PC location, 0024. 


Single-stepping allows you to see the results of each instruction as it is 
executed, but is a slow way to progress through a program. For portions 
of a program where you do not need to observe instruction-by-instruction 
execution, you can initiate continuous program execution. The simulator 
executes instructions at its maximum speed updating windows only 
periodically. If you press any key during continuous program execution, 
the simulator stops at whatever instruction it has reached. 


To start continuous program execution: 


1. Enter 
> go 
or 


> J 


in the command window. 


During program execution the word RUNNING flashes in a pop-up 
window in the center of the display. The display is updated periodically. 
The simulator executes the rest of the program until it reaches the IDLE 
instruction. It then continuously executes this instruction. The PC will stay 
at address 002C. The only value in the display that continues to change is 
the cycle counter (CYCLE) in the program control window. Press any key 
to stop execution. 


To execute the program again, you must clear the program counter back 
to address 0000. You can clear the program counter and the DAG registers 
to their default states with a reset command (RESETNOBOOT). When you 
use the RESETNOBOOT command, the program stays loaded in memory. 
You can also use the chip reset command (CR) to simulate a hardware 
reset of the chip, but then you have to reload the executable program. 


To reset the PC and DAG registers: 


1. Enter 
> resetnoboot 
or 
> re 


in the command window. 


The program counter moves back to address 0000, and the DAG registers 
return to their default values. 


If you want the simulator to stop at a specific location, you set a breakpoint 
at that location before starting program execution. The simulator will halt 
after it executes the instruction just before the breakpoint instruction. In 
this example, you will set a breakpoint at the start of the loop to halt the 
simulator after each iteration. 


To set a breakpoint at the start of the add_loop loop: 
1. Activate the program memory window by clicking inside of it. 
2. Type “G. The pop-up window appears. 


3. Enter ADD_LOOP and press Return. Address 0028 is displayed at 
the top of the program memory window. 


4. Double click on the dm(Z_OUT) =ar instruction (or press F9) and 
the first column of the line is highlighted indicating a breakpoint set 
at that location (see Figure 7.6, on the following page). 


You may want to widen the program memory window to make all the 
disassembled code visible. 
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DAG Registers (Hexadecimal) Computational Registers (Hexadecimal) 
> UU MB: uuUU LO: uuu active 

> UU Mi: uuu Li: uuuu > UULULUL AX1: uuuu AR: uuuu 

> UU M2: uuu LZ: uuu as > ULL AY1: uuu AF: wuuuu 

> uuu =M3: uuu = =0L3! uuu > uuu = =oMX1: uuu 

> UU M4: uuu L4: uuu ie > UUULLLLL MY1: uuu MF: uuu 


> uuu MS: uuu LS: uuu i > uuuu MRI: uuu MRZ: uu 
> ULL M6: uuu L6: uuuu i > ULL SR1i: uuuu 
> UULULL M7: uuu L7: uuu > ULL SE: uu SB: uu 


ADD_LOOP: 

IRAM [6628] dm(Z_OUT) = ar 

IRAM [6629] ar = ax + ayf 

IRAM ([66@2Za] dm(Z_OUT) = ar . 

IRAM ([462b] idle 8 #- Program Control (Hexadecimal) 
IRAM [@62c] spare aaae 

IRAM [462d] spare . : UU 

IRAM [662e] spare : lalalalalalals) 

IRAM [662f1] spare 2 PM_ADDR: uuuu 

IRAM [6636] spare DM_ADDR: uuuw 


Figure 7.6 Breakpoint At ADD_LOOP Label 


There are two additional ways to set breakpoints. You can set a breakpoint 
from inside the command window by entering: 


> break pm(0x0028) 
or 


> b pm(0x0028) 


Or 


> b pm(ADD_LOOP) 


Or, once the desired instruction in program memory is highlighted, select 
Set/Clear Breakpoints from the Execution menu. 


Now you can quickly execute all the instructions from the current PC 
location to the breakpoint. 


Get 


To execute the program up to the breakpoint: 


1. Activate the command window. 
2. Enter 
> go 
or 
> J 


in the command window. 


The command window displays a message immediately indicating that 
the simulator has reached the breakpoint and also displays the value of 
the PC. Press Return or click on “OK” to remove this window. The 
program memory window is updated to the location of the PC. Notice 
that the values in the computational registers window show that the first 
sum has been calculated (AR=000C) and the operands for the next sum 
(AX0=0002, AY0=000C) have been fetched. [2 and I6 have been updated to 
point to the third pair of operands. 


If you enter the GO command again, you will observe the simulator 
execute another loop iteration. The values in the register window change 
accordingly. 
To remove the breakpoint: 

1. Activate the program memory window. 


2. Move the cursor to address 0028, the location of the breakpoint. 


3. Double click on that line (or press F9) to remove the breakpoint. 
Notice that the first column is no longer highlighted. 


There are several additional ways to remove breakpoints. You can remove 
a breakpoint from the command window by entering the breakpoint 
delete command: 


> breakdelete pm(0x0028) 
or 


> bd pm(0x0028) 
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Or, once the desired line in program memory is highlighted, select Set/ 
Clear Breakpoints from the Execution menu. 


To delete all existing breakpoints, use this form of the breakpoint delete 
command: 


> bd all 


7.5.1.6 Simulating Memory-Mapped I/O 
The example program writes output to a memory-mapped I/O port at 
DM(0x0000), labelled Z_OUT. You can collect this output by associating 
the port with a data file. After program execution, you can inspect the 
program results in the data file. 
To open an output file for collecting I/O port data: 

1. Activate the command window. 

2. Enter 

> openport Z_OUT >'out.dat' 


Or 


> Op Z_OUT =" out, dac" 
in the command window. 


The simulator creates the file out .dat to receive all data written to 
A OUT. 


Now enter go in the command window to execute the rest of the program. 
Press any key to halt execution. 


To view the file out .dat, open the display file window: 
1. Select Display File from the File menu. 
2. Enter out .dat into the pop-up window and press Return. The 


contents of out.dat are displayed in the display file window as 
shown in Figure 7.7. 
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DAG Registers (Hexadecimal ) Computational Registers (Hexadecimal) 
> UULULL MA: HHb1 L#: active 

> UU > UU 8 : 66a > uuun AR: 66@1e 

: 38a > ULLLULLL : e : 6614 > ULLULLL AF: uuuu 

> UU > ULLLLUL : > ULL > UU 

> ULULLLUL > ULL : > ULLLLLUL > UULULLUL MF: uuu 

> LUULULLL : 4661 : ZRA: uuuU > UU 

: 646e > ULUULLLUL : > UALLLLUL 


Program Memory (Disas 
IRAM [66271 ar = ax + ay, a 
dm(Z_ OUT) 
ar = ax + ay 
dm(Z OUT) = ar Ee 
[462b1 idle : : 442c 
[462c] spare ; UU 
[662d] spare i : HHbb3b11 
[462e] spare e : 666d 
[662f] spare : 


Figure 7.7 Display File Window (out.dat) 


The displayed data should be some portion of the following values, 
depending on how many loop iterations you executed before creating the 
out.dat file: 


OUGC 
OOOE 
OO1O0 
0012 
0014 
0016 
0018 
OO1A 
OO1C 
OO1E 


7.5.1.7 Using The Trace Feature 


The trace window captures a history of processor activity during program 
execution. 


To open the trace window: 
1. Select Trace from the Misc menu. 


The trace window shows the last 10 instructions executed, cycle by cycle 
(see Figure 7.8). Here they include the last iterations of the loop. Notice 
that the trace also shows the values on the address buses during the 
operand fetches. 


7.5.1.8 Quitting The Simulator 

The next part of the tutorial uses a different program and architecture 
description file. To prepare these files, quit the simulator and return to the 
operating system. 
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Trace Window 
ar alalala! 
dm(iZz,mA), ay 3807 Rd of 46 
ar HHA 
dm(CiZz,mH), ay 3808 Rd of HH 
ar alalala! 
dm(iZ,m6), ay 3869 Rd of 44 
ar HHHb 


ADD LOOP: dm(Z_OUT) 
ar = ax + ayfi, ax 
ADD _ LOOP: dm(Z_OUT) 
ar = ax + aul, ax 
ADD LOOP: dm(Z_OUT) 
ar = ax + ay, ax 
ADD_LOOP: dm(Z_OUT) 
ar = ax + ayf 
dm(Z_ OUT) = ar HHHH 
idle 


11:32:14 


Figure 7.8 Trace Window With Vector Addition Program 


To quit the simulator: 
1. Select Quit from the Quit menu. 


2. In the pop-up window, click on “No” (changes into “YES”), then 
press Return. 


7.5.2 Serial Port Simulation 


This part of the tutorial applies to all processors except the ADSP-2100, 
because it makes use of internal memory and a serial port, both of which 
the ADSP-2100 does not have. 


These operations are described in the first part of this tutorial: 
¢ Boot operation—Booting internal program memory from boot memory. 


e Viewing memory-mapped control registers—Displaying registers that 
are mapped to reserved data memory locations. 


e Simulating serial [/O—Using data files to represent data coming from 
or going to a serial device. 


e Interrupt servicing—Using program control commands to observe the 
simulation of interrupts. 


e Generating external signals—Setting up the simulator to generate 
periodic inputs to the simulated processor. 


e Altering program memory—Changing an instruction in program 
memory. 


7.5.2.1 Creating Example Program #2 

The example program for this part, shown in Listing 7.2 (starting on the 
following page), receives a value in SPORT1 then transmits it through 
SPORT1; it simply passes serial data through the SPORT. Companding is 
enabled, so the received value is expanded then compressed again before 
being transmitted. The example program stores code and data in boot 
memory; they are loaded into internal program memory at reset. 


The program initializes all memory-mapped control registers. This action 
is not strictly necessary, since most of the functions controlled by these 
registers are not used in this case, but it is a good programming practice. 
Notice that the interrupts are configured before the SPORT1 receive 
interrupt is unmasked. Likewise, SPORT1 is not enabled until it has been 
completely configured. 


The main part of the program is an infinite loop that waits for an interrupt 
(the SPORT1 receive interrupt) to occur. The interrupt service routine 
performs all data processing, in this case transferring data from the 
SPORT receive register to the SPORT transmit register. 


Before proceeding with the tutorial, you must assemble and link the 
program shown in Listing 7.2. The three files used in this example are 
supplied with the release software in the example2 directory. Generate 
the architecture description file using the command: 


> bld21 example2 


This yields the file example2.ach. Assemble the program using the 
command: 


> asm21 sport 


The assembler creates the files sport.obj, sport.cde and 
sport .int. Link the files using this command: 


> 1ld21 sport -a example2 -e sport -g 


This creates the files sport.exe and sport.sym. Using the -g 
switch creates the symbol table so that the simulator can display labels 
and variable names. 


Once you have generated the executable file sport .exe you can invoke 
the simulator, specifying example2.ach as the architecture description 
file. You can use any simulator except the ADSP-2100 simulator, which 
does not support serial ports. For example, to invoke the ADSP-2101 
simulator, you enter: 


> sim2101 -a example2 


File: EXAMPLE2.SYS 


- SYSTEM example; 

-ADSP2101; 

. MMAPO; {boot at reset} 
. SEG/ROM/ BOOT=0 boot_mem[2048]; 

. SEG/ PM/RAM/ABS=0/CODE/DATA int_pm[2048]; 

. SEG/DM/RAM/ABS=14336/DATA int_dm[1024]; 

». BNDSYS ; 


File: SPORT.DSP 
. MODULE/RAM/BOOT=0/ABS=0 
{ Interrupt vector table 


JUMP start; NOP; NOP; 

RIL; NOP? NOP: NOP; 

RTI; NOP; NOP: NOP; 

RTI; NOP; NOP; NOP; 

RTI; NOP; NOP; NOP; 

JUMP sample; 

RTI; NOP; NOP; NOP; 
{ Initializations 
start:  AxX0=0x0000; 

DM (0x3FFE) =AX0; 

DM (0x3FFD) =AX0; 

DM (Ox3FFC) =AX0; 

DM (0x3FFB) =AX0; 

DM (Ox3FFA) =AX0; 

DM (0x3FF9) =AX0; 

DM (0x3FF8) =AX0; 

DM (O0x3FF7) =AX0; 

DM (0x3FF6) =AX0; 

DM (O0x3FF5) =AX0; 

DM (0x3FF4) =AX0; 

DM (0x3FF3) =AX0; 

AX0=0x6B27; 


DM (Ox3FF2) =AX0; 


AX0=0x0002; 
DM(Ox3FF1) =AX0; 
AX0=255; 

DM (Ox3FF0O) =AX0; 
AX0=0x0000; 

DM (OxX3FEF) =AX0; 


LCNTL=0x07 : 
IMASK=0x02; 


AX0=0x0C00; 
DM (OX3FFF) =AX0; 


Getting Started 


NOP; 


} 


NOP; NOP; NOP; 


talkthru; 


{reset vector} 


{IRQ2 } 

{SPORTO 
{ SPORTO 
{SPORT1 
{SPORT1 
{Timer} 


transmit } 
receive} 
transmit } 
receive} 


{all DM wait states 0} 
{timer not used} 


{registers cleared} 


{receive multichannels} 
{disabled} 
{transmit multichannels} 
{disabled} 


{SPORTO 
{SPORTO 
{SPORTO 
{SPORTO 


control not used} 
timing not used} 
timing not used} 
autobuf disabled} 


{internal serial clock, } 


{RFS reqd, normal framing, } 


{TFS reqd, 
{internal RFS, 
{companding, 


normal framing, } 
TFS, mu-law} 
8-bit words} 


{generate 2.048 MHz SCLK1} 
{from 12.288 MHz CLKIN} 
{divide by 256 for 8 kHz} 
{sampling rate} 


{SPORTI1 


{enable 
{enable 


{SPORT1 
{states 
{states 


autobuf disabled} 


edge-sensitive irqgs} 
SPORT1 receive irq} 


enabled, PM wait} 
0, boot wait} 
0, boot page 0} 


(listing continues on next page) 


{ 


Wait for sampole———————} 


walt: IDLE; {wait for receive irq} 
JUMP wait; 

{ Process sample———————} 

sample: AX0=RX1; {put receive sample in AX0} 
TRI=AX0; {transmit sample in AX0} 
RTI: 

. ENDMOD; 


File: SERIN.DAT 
10100101 
00111100 
11110000 
00001111 
00011000 
11000011 


Listing 7.2 Example Program #2: Talk-Through 


7.5.2.2 Booting Internal Program Memory 

The S2101_x.WIN file stores the window configuration that was active 
at the end of the last simulator session. The simulator reads this file at 
startup. You should see that the windows are opened and positioned just 
as they were when you quit. Before proceeding with this part of the 
tutorial, close all windows except the command window. 


When you invoke the simulator, it configures its memory space according 
to the architecture description file (example2.ach in this case). Loading 
the memory image file, sport . exe, initializes boot memory. Because 
the architecture description file specified an MMAP value of 0, a chip reset 
causes the simulated processor to transfer the contents of boot page 0 into 
internal program memory. 
To load the file sport.exe: 

1. Enter 


> load ‘sport’ 


in the command window. 


You can observe the booting operation in the program memory and boot 
memory windows. 


To open the program memory and boot memory windows: 


1. Select Program Memory Display from the Memory menu. 


2. Select Boot Memory Display from the Memory menu. 


Move the memory windows so that both windows are visible, as shown in 
Figure 7.9. Notice that boot memory contains the program and program 
memory is not yet initialized. 
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Figure 7.9 Program Memory & Boot Memory Windows Before Booting 


Register Memory Stacks Command Execution 
Program Memory (Disassembled) 


[6666 ] 
[66611] 
C4662] 
[46631] 
[4664 ] 
[64665 ] 
[4466 1 
[4667 1 
[4648 ] 
[4669 1] 


LIULLEUE LULL UL ULE UU LU UU 
CALLE LLE UL LUU U UO 
CLUE LEELA 
ULLLULUL UL ULL UL ULE LULU UL 
CULL ULL LEE CLLE ULL UL UL LULL UU 
CLULLLUL UL ULL LULU UL UU UE UU UU 
CAULUL ULLAL LLL UE ULL LEU 
CULL LEU LULU ULL UE ULL UO LU Ut 
LLU LLU UU UU LU UU 
CAUULULULULULLLLLELEU UL U U LEULUU UL 


Boot Memory (Disassembled) —— 


[6646 ] 
(66611 
[4482 1 
C4463 1 
(4664 J 
(4665 ] 
[4666 1 
(6667 1 
(6666 1 
(44669 1] 


jump START 
nop 
nop 
nop 
rti 
nop 
nop 
nop 
rti 
nop 


Display Misc Help Quit 


ommand Window (Hex) 


13:62:63 


A chip reset will cause the simulated processor to perform a boot of page 
0. 


To reset the simulated processor, causing a boot-on-reset: 


1. Activate the command window. 
2. Enter 
> chipreset 
or 
> cr 


in the command window. 


The program memory window is updated with the contents of boot page 
0 (see Figure 7.10). Notice that all labels in boot memory are prefixed with 
ROMO to indicate their origin. The program counter highlights address 
0000. 


Register Memory Stacks Command Execution Display Misc Help Quit 
Program Memory (Disassemb led) 

[6666] jump START 

[646611 nop 

[66621] nop 

[46631] nop 

[66641 rti 

[646651] nop 

[66661] nop 

[46671 nop 

[6668] rti i 

[66691] nop ommand Window (CHex) 


Boot Memory (Disassembled) ———]|> 
[6666] jump START 
[66611 nop 
[4662] nop 
[66631] nop 
[6664] rti 
[66651 nop 
[6666] nop 
[66671] nop 
[66681 rti 
[66691 nop 
13°62 31 


Figure 7.10 Program Memory & Boot Memory Windows After Booting 


7.5.2.3 Viewing Memory-Mapped Control Registers 


The memory-mapped control registers initialized by this program can be 
viewed from two windows: the control register window and the SPORT1 
register window. Before opening these windows, close the boot memory 
window. It is a good practice to close windows you are not using because 
it reduces crowding in the display and frees the simulator from excessive 
window-management overhead. 
To close the boot memory window: 

1. Activate the boot memory window. 

2. Press Escape. 
To open the SPORT1 registers and control registers windows: 

1. Select SPORT1 from the Register menu. 


2. Select Control Registers from the Register menu. 


Move the windows so that all the windows are visible (see Figure 7.11). 
You may have to resize the program memory window. 
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Program Memory (Disassembled) Sport 1 Registers (Hexadecimal) 

IRAM [6666] jump START SLENi: 6 DTYPE1: 6 ISCLK1: 6 

IRAM [6661] nop : IRFS1: @ RFSR1i: @ RFSW1: @ INVRFS1: 6 # 
IRAM [6662] nop a ITFS1: 6 TFSR1i: 6 TFSW1: @ INUTFS1: 6 # 
IRAM [64831 nop @ |SCLEDIV1: uuu RFSDIV1i: uuuu A 
IRAM [6664] rti q RBUF1i: 6 RIREG1: u RMREG1: u 

IRAM [6665] nop . TBUF1: @ TIREGi: u TMREG1: u 

IRAM [6666] nop e |RX1: uuu TX1: uuuu 

IRAM [66671 nop i: 

IRAM [6668] rti 


IRAM [64669] nop ] ommand Window (CHex) 


Control Registers (Decimal) 
BF: 6 SPEB@: 6 DWAIT@: 7 DWAITS: 7 TSCALE: uuu 
BPAGE: 6 SPE1: 6 DWAIT1: 7 DWAIT4: 7 TPERIOD: uuuuu 
BWAIT: 3 SCNF1i: 1 DWAITZ: 7? PWAIT: 7? TCOUNT: uuu 


13 66:64 


Figure 7.11 Control Register & SPORT Register Windows 


7.5.2.4 Simulating Serial l/O 


The file serin.dat in this example provides input for the serial port. 
You can create an output file to collect the data transmitted by the serial 
port. This file allows you to check the program’s functioning, since the 
output data should match the input datain serin.dat. 


To associate SPORT1 with files for serial input and output: 
1. Activate the command window. 
2. Enter 
> opensport 1 >’serout.dat’ <‘serin.dat’ 
in the command window. 


The simulator creates the file serout.dat and opens the file 
serin.dat for reading SPORT1 input. 


7.5.2.9 Interrupt Servicing 

The program initializes registers and waits for an interrupt. SPORT1 has 
been configured to generate its RFS (receive frame sync) internally at an 8 
kHz rate. Therefore it will sample the input data at a (simulated) rate of 8 
kHz and raise an interrupt when it has received a full 8-bit word. In 
response, the simulated processor jumps to location 0014, the vector 


(address) for the SPORT1 receive interrupt. From there the program jumps 


to the service routine at the label SAMPLE. 
To help you observe the execution of the program, set a breakpoint at 
0x0014 in program memory. This instruction jumps to the interrupt 
service routine. 
To set a breakpoint at the jump to the service routine: 

1. Activate the command window. 

2. Erter 

> break pm(0x0014) 


You can verify that the breakpoint is set by activating the program 
memory window and scrolling to address 0014. 


Now you can initiate program execution. The simulator will halt when it 
encounters the breakpoint. 


To execute the program up to the breakpoint: 

1. Activate the command window. 

2. Enter 

> go 
in the command window. 

The simulator displays a pop-up window indicating that a breakpoint was 
reached. Press Return to remove the window. When the simulator halts, 
notice that registers in the control register window and SPORT1 register 
window have been initialized as shown in Figure 7.12, and the RX1 


register contains the value 0x067F. This is the expanded and sign- 
extended value of 10100101, the first 8 bits in the serin.dat file. 
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Figure 7.12 Control Register & SPORT Register Windows After Initialization 


Now, close the control register window and open the program control and 
computational register windows. If necessary, resize the computational 
register window so that the SPORT1 register window contents are also 
visible (you only need to view the AXO register in the computational 
register window). Then single-step through the service routine and 
observe the contents of the registers RX1, AXO and TX1. 


To single step: 


1. Activate the command window. 
2. Enter 
> step 
or 
> s 


in the command window. 


Single-step twice more and observe that the value in RX1 appears in AXO, 
then in TX1. Again, single-step twice and the value in TX1 changes to 
OxFFA5, which is 0x067F compressed and sign-extended. The companding 
hardware compresses the TX1 value then writes it back to TX1 for 
transmission. 


You can determine exactly how many processor cycles elapse between 
interrupts by reading the cycle counter in the register window. 


To show the cycle count as a decimal value: 
1. Activate the program control window. 


2. Type “T to toggle the window format until the window displays 
decimal data. 


Now activate the command window and enter the GO command to 
continue program execution. The simulator displays a pop-up window 
indicating that a breakpoint was reached. Press Return to remove the 
window. When the simulator halts, it updates the cycle counter. The 
counter should show that approximately 1500 cycles have elapsed since 
the previous interrupt. 


7.5.2.6 Simulating External Control Signals 


In the example program sport .dsp,SPORT1 is configured for internal 
generation of RFS1, and thus the processor samples its DT1 serial data 
input at an internally programmed rate. ADSP-21xx processors can also 
accept externally generated frame sync signals. In this case, an external 
device determines when serial data should be input or output. The 
simulator can simulate a number of external inputs, including external 
frame syncs. 


In the following procedure, you will change the program so that it 
configures an externally generated RFS1. Then you will set up the 
simulator to provide the RFS1 signal. 
Before proceeding, reset the simulator: 
1. Activate the command window. 
2. Enter 
> chipreset 
in the command window. This reloads the program from boot 
memory, sets registers to their default values and moves the PC to 
location 0. 
3. Enter 


> opensport 1 >’serout.dat’ <‘’serin.dat’ 


in the command window to reset the file pointers to serin.dat 
and serout.dat. 


To change the program to configure SPORT1 for external RFS1 
generation: 


1. Activate the program memory window. 
2. Type “G and enter 0029 in the pop-up window. 
3. Press Return and the cursor will highlight the first letter of the 


instruction at location 0029, the instruction that loads AXO with the 
value 0x6B27. 


Started 


4. Type “ax0 = 0x6a27” and press the Return key. The new text 
replaces the old instruction. The simulator automatically assembles 
the new instruction and places it in memory at location 0029. 


Now restart program execution to set up the new SPORT1 configuration. 
1. Activate the command window. 
2, Eriter 
> go 
in the command window to start program execution. 


The simulator will execute the initializations and then loop on the IDLE 
instruction waiting for an interrupt. But no interrupt will occur because 
the SPORT is not receiving any RFS signal and will not input any data. 
Press any key to halt program execution. 


To set up the simulator to generate RFS1 every 200 cycles: 


1. Enter 
> interrupt rfsl 200 
or 
> 1 rfsl 200 


in the command window. 


Now if you start program execution again, the simulation runs as before. 
When SPORT1 has input 8 bits, it generates the SPORT1 receive interrupt, 
and the simulator halts because of the breakpoint at location 0014. 


To complete the processing of the datain serin.dat, remove the 
breakpoint and restart program execution. The simulator will halt when it 
reaches the end of the serin.dat file. 


7.5.2.7 Finishing Up 


Now exit the simulator by typing exit in the command window and 
pressing Return. Check the serout.dat file. 


Enter: 
C:\> Type serout.dat 
to display the file. 
The datain serout.dat should match the datain serin.dat: 


10100101 
00111100 
11110000 
00001111 
00011000 
11000011 


This completes the simulator tutorial. We have presented a representative 
sample of simulator functions and displays, but there are many more; all 
of the simulator’s capabilities are described in the chapters that follow. As 
you simulate your own programs, refer to these materials to learn more 
features. 


User Interface 


8.1 OVERVIEW 


The simulator’s interface is a window-oriented graphical user 
interface, or GUI. If you are familiar with GUIs, some of the 
information in this chapter will reinforce what you already know. You 
may wish to skim through this information before continuing on to the 
rest of the manual. But if you are a new GUI user, take the time to read 
through this chapter, run the simulator, and practice with the interface. 
This chapter contains the following sections: 


e Starting the simulator—describes the basic steps required to start the 
simulator (for additional information, see Chapter 7, Getting Started) 


e Screen objects—describes the mouse cursor, menus, and windows and 
how to work with them 


e Working with display windows—explains manipulating the windows, 
entering data, and saving the window setup 


e Changing window colors—explains customizing the window colors 
e Help system—describes the on-line help utility 
e¢ Keystroke files—explains creating and using keystroke files (macros) 


e Exiting and quitting—explains leaving the program 


8.2 INVOKING THE SIMULATOR 


The simulator invocation command is: 


SIM21XX _ [-a filename] [-e filename] |-k filename] |-o filename] 
[-w filename] |-c] |-help] 


where: 
SIM21XX simulator .EXE file—SIM2100, SIM2101, SIM2111, 
SIM2150, or SIM2171 
filename specific file name; the file type varies according to the 


command switch, however the file extension (.ACH, 
.EXE, .KSF, or .WIN) is not required 


The simulator program name can be uppercase or lowercase, except in 
UNIX systems in which it must be lowercase. The following command 
line, for example: 


C:> sim2101 -a myarch 


invokes the ADSP-2101 Simulator with an architecture file named 
MYARCH.ACH. 


8.2.1 Command Line Switches 

-a filename 

To use an architecture description file other than the default 210x.ACH, 
you must list this file with the -a switch. The extension .ACH is assumed 
for this filename and need not be included. This architecture description 
file must have been used to link your program; the simulator configures 
itself according to this target architecture. 


If the processor specified in the architecture description file does not 
match the simulator program being invoked (e.g., the file contains the 
.ADSP2100 directive but the program name is SIM2101), the simulator 
displays a warning and proceeds. If the architecture file named with the 
-a switch does not determine the setting of MMAP, the simulator defaults 
to a setting of MMAP=0. 


When the ADSP-21msp50 simulator (SIM2150) is invoked with an ADSP- 
21msp51 architecture file, the simulator automatically configures itself for 
the on-chip memory configuration of the ADSP-21msp51. If an ADSP- 
21msp51 is specified in the architecture description file and the 
ROMENABLE bit is set to 1, the simulator defines program memory 
locations PM(0x0800)-PM(0x1000) as ROM; otherwise, they are (external) 


RAM. The ROMENABLE bit is displayed in the simulator’s control 
registers window. 


Use the ADSP-2101 Simulator (SIM2101) to simulate an ADSP-2105 or 
ADSP-2115 system. If the architecture description file specifies an ADSP- 
2105 or ADSP-2115, the portions of internal memory in the ADSP-2101 
which do not exist in the ADSP-2105/ADSP-2115 are displayed in the 
simulator as non-existent. 


-C 

The -c switch makes the simulator case-sensitive for any symbols used in 
assembly code (variable/buffer names and address labels). Normally the 
simulator is case-insensitive, treating uppercase and lowercase characters 
the same; use the -c switch if you need to differentiate between the two. 
Example: loop1 Loop 1 


-e filename 

To load an executable file automatically when invoking the simulator, use 
the -e switch followed by the file name. The .EXE extension is not 
required. 


-help 
The -help switch displays the syntax of the simulator invocation command 
and the options available. The simulator is not invoked. 


-k filename 

You can load and run a keystroke file when starting the simulator with the 
-k switch. This switch only works with keystroke files that were created 
and saved during earlier simulator sessions. The simulator automatically 
assumes the .KSF extension when you use this switch, so you need not 
include it. 


-o filename 

The -o switch creates an ASCII output file that contains the messages 
displayed in the Command Output Window and the contents of all pop- 
up error windows generated during the ensuing simulator session. The 
software does not automatically append extensions to these text files. 


-w filename 

The -w switch starts the simulator with the specified windows 
configuration rather than the default configuration. If you do not use 
the -w switch, the simulator reads the windows configuration stored 
in the default file. The simulator also automatically overwrites the 
default windows file when exiting, so that the default at startup 
always matches the last windows configuration used in the last 
session. If the -w switch is not used and the default .WIN file is not 
found, only the command window will open.system. 


8.3 SCREEN OBJECTS 


All GUIs comprise a variety of screen objects that you manipulate to 
interact with the software. The basic screen objects for the simulator’s 
GUI include: 


mouse cursor 
menu bar 
drop-down menus 
windows 


You control the simulator by using these objects and entering text or 
data through the keyboard. Figure 8.1 illustrates the GUI and identifies 
the basic screen objects. 
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Figure 8.1 The GUI & The Screen Objects 


8.3.1 Mouse Cursor 


The mouse cursor is logically linked to the mouse, so as you move the 
mouse, the cursor moves accordingly. Use the mouse to display 
menus, select commands, move and resize windows, and highlight 
data. 


(Note: Your mouse can have one, two, or three buttons. Regardless of 
the number of buttons, the simulator works with your mouse.) 


8.3.1.1 Using The Mouse 


The easiest way to control the simulator is with a mouse using two 
basic mouse actions, clicking and dragging. 


e Clicking means pressing and releasing the mouse button. 


e Dragging means pressing and holding the mouse button, moving the 
mouse, then releasing the button. 


8.3.1.2 Using The Keyboard 


If you don’t have a mouse you can control the simulator entirely 
through the keyboard. 


There are two ways to use the keyboard: 


e Use the arrow keys (<, >, T, and J) to move through the menus 
and execute commands 


¢ Use the function keys or control key combinations, such as F4 or Cntl-G. 


For more information about keyboard commands, refer to the 
individual sections of this chapter. 


8.3.2 Menu Bar 


The menu bar is the row of words across the top of the screen. These 
words are the titles of subordinate menus called drop-down menus. 


8.3.3 Drop-Down Menus 

Drop-down menus are groups of related commands that you access by 
selecting an item from the menu bar. You can open only one drop- 
down menu at a time; an open menu closes automatically when you 
open a new menu. 


8.3.3.1 Displaying Menus 


To display a drop-down menu: 


e Drag the cursor over a command in the menu bar to highlight it, 
then release the mouse button. 


or 
e Position the cursor over a command , then click with the mouse. 
To display a menu from the keyboard: 


1. Press F3 to highlight the first item in the menu bar. 


2. Use <— and — to move the highlight bar. 
3. Press J to open the drop-down menu. 


8.3.3.2 Executing Commands 
To execute a command from a drop-down menu: 


1. Drag the mouse to display a drop-down menu, then drag the 
highlight bar to a drop-down menu item. 


2. Release the mouse button while the item is highlighted. 
or 
1. Click on a word to display the drop-down menu. 
2. Click on a drop-down menu item. 
To execute a command from the keyboard: 


1. Press F3 to highlight the first item in the menu bar. 


2. Use <— and —> to move the highlight bar. 


3. Use J to display the drop-down menu and move the highlight bar. 


4. Press Return to execute the command. 


8.3.3.3 Closing Menus 


To close an open menu without making a selection, press Esc. 


8.3.4 Windows 


The simulator displays information in rectangular screen objects called 
windows. The interface uses the following types of windows: 


Display windows—windows you open by executing specific 
commands that remain open until you close them. For example: 
register and memory windows. 


Pop-up windows—temporary windows that appear as needed and 
disappear when they have served their purpose. 


File selection windows—windows that appear in response to specific 


commands that require you to enter a file name (from the keyboard). 


8.3.4.1 Display Windows 


You open display windows from the drop-down menus. Once opened, 
these windows remain open until you close them. Because these 
windows remain open, the simulator automatically updates the 
window contents. 


You can open multiple display windows at once, and they can extend 
beyond the visible screen area. They can partially overlap or totally 
cover one another, with the top window casting a shadow over the 
windows beneath it. 


These windows have several attributes, including size, position, and 
border color. Generally, you can change the window’s attributes 
through menu selections or keyboard commands. 


8.3.4.2 Pop-Up Windows & Buttons 


Some commands invoke special windows for displaying and entering 
command options or displaying system information and errors. These 
windows are called pop-up windows because they appear as needed. A 
pop-up window often has a button used to trigger an action. After 
pressing a button to select a command option or acknowledge the 
window’s presence (“OK” button in error windows), the window 
automatically disappears. 


To remove a pop-up window, press Esc. 


8.3.4.3 File Selection Windows 


Some commands, such as Load Executable File, require you to enter a 
file name in a file selection window before you can execute the 
command. You enter file names from the keyboard. If the file name 
you want to enter is not in the default directory (the directory you 
invoked the simulator from) you must include the full path with the 
file name. 


To remove a file selection window, press Esc. 


8.4 WORKING WITH DISPLAY WINDOWS 


Display windows are the only windows where you can change the 
status, size, and position, so the information in this section specifically 
refers to display windows. Figure 8.2 identifies the parts of a display 
window. 
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Figure 8.2 Parts Of A Display Window 


8.4.1 Opening Windows 


You open these windows by selecting menu items, and each item 
invokes a different window. You can open as many windows as you 
need, and you can open multiple copies of the same window—use this 
particular feature, for example, if you want to examine more than one 
section of data memory at the same time. 
To open a window: 

1. Drag the mouse to display a drop-down menu. 


2. Drag the highlight bar to a window name, then release the mouse 
button. 


or 
1. Click with the mouse to display a drop-down menu. 
2. Click on a window name. 
To open a window from the keyboard: 


1. Press F3 to highlight the first item in the menu bar. 


2. Use <— and > to move the highlight bar. 


3. Use J to display the drop-down menu and move the highlight bar. 


4. Press Return to open the window. 


8.4.2 Closing Windows 
To close a window, press Esc when the window is active (see Section 
8.4.3, “Activating & Exposing Windows”) 


8.4.3 Activating & Exposing Windows 

A display window is either active, indicated by the border color 
(default is a red border), or inactive (default is a blue border). Only one 
window is active at a time, and a newly opened window automatically 
becomes active. 


You can activate windows with the mouse, function keys, and from a 
menu item. 
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8.4.3.1 Activating Windows With The Mouse 

As long as the interior of a window is partially visible, you can activate 
the window with the mouse. Although this make the window active, it 
doesn’t bring partially hidden windows to the foreground. See Section 
8.4.3.4, “Exposing Inactive Windows” for additional information. 


To activate a window with the mouse: 


Move the cursor inside the window border, then click with the mouse. 


Clicking on the border or a corner of the window does not activate it. 


8.4.3.2 Activating Windows With The Function Keys 


With a function key, you can activate and expose each window in turn, 
according to the sequence in which you originally opened the 
windows. 

To activate a window with a function key: 


Press F2. 


The next window is activated and exposed. By pressing F2 repeatedly, 
you can browse through all the open windows. 


8.4.3.3 Activating Windows From A Menu 


You can also activate and expose a window by selecting it from a pop- 
up list of open windows. 


To activate a window from the pop-up list: 
1. Click on Display in the menu bar to display the drop-down menu. 
2. Click on List Windows. 
3. Click on a window name. 

To activate a window from the menu with the keyboard: 


1. Press F3 to highlight the first item in the menu bar. 


2. Use — and —> to move the highlight bar to Display. 


3. Use J to display the drop-down menu and move the highlight bar to 


List Windows. 


4. Press Return to display the pop-up list of open windows. 


5. Use L to move the highlight bar to a window name, then press 
Return. 


Or 


1. Press Cntl-L to display the pop-up menu of windows. 


2. Use J to move the highlight bar to a window name, then press 
Return. 


This is particularly useful if you have a window that is completely 
obscured by other windows. 


8.4.3.4 Exposing Inactive Windows 


You can expose an inactive window by clicking the mouse on the 
window title (see Figure 8.2). 


8.4.4 Moving Windows 


You can move active windows with the mouse or keyboard, but you 
can only move inactive windows with the mouse. 


To move a window with the mouse: 


1. Position the cursor anywhere on a window border, except on a 
corner or scroll bar (see Figure 8.2). 


2. Drag the window to its new location, then release the mouse button. 


To move active windows with the keyboard, see Table 8.1, which can 
be found on the following page. 


8.4.5 Resizing Windows 


You can resize active windows with the mouse or keyboard. 
To resize a window with the mouse: 


1. Position the cursor on a window corner, anywhere except on a 
border or scroll bar (see Figure 8.2). 


2. Drag the corner to resize the window, then release the mouse 
button. 
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The corner you click on moves as you move the mouse, but the 
opposite diagonal corner stays fixed. 


To resize active windows with the keyboard, see Table 8.1. 


Key(s) Moving Resizing 
FD Up 

F6 Down 

F7 Left 

F8 Right 

Shift-F5 Taller 
Shift-F6 Shorter 
Shift-F7 Wider 
Shift-F8 Narrower 


Table 8.1 Keys For Moving & Resizing Windows 
8.4.6 Centering Windows 


Sometimes you may push a window so far to the side of the screen and 
cover it with another window that you cannot click on it. Select Center 
Windows from the Display menu to move all windows to the center of 
the screen. 


After you center the windows, you can expose the desired window. 


8.4.7. Entering Data 

You can enter data directly into windows to write to the processor 
registers or make temporary changes to the application program. You 
can write data into a window only when it is active; when you select a 
field in the window it automatically becomes active. 


8.4.7.1 Fields & Labels 


Windows contain fields and labels (see Figure 8.2). A field displays the 
data contained in a processor register, functional unit, or memory 
location. A label is the text or address that identifies each field. 


To edit the contents of a field with a mouse: 
1. Click on the field. The field changes color to indicate that you can 
input data. If the field does not change color, the data can be 


changed only by program execution. 


2. Type new data into the field, then press Return. 


To edit the contents of a field with the keyboard: 


1. Activate the window. Press F2 to cycle through the windows, or 
Press Cntl-L and select a window from the list. 


2. Use the arrow keys to highlight the desired field. 
3. Type new data into the field, then press Return. 


8.4.8 Scrolling A Window’s Contents 

Windows often contain more information then can be displayed. You 
can change a window’s size (see Section 8.4.5, Resizing Windows), but 
you still may not be able to display the entire contents. When 
necessary, you can scroll through a window’s contents by using the 
following items shown in Figure 8.2: 


Scroll bar—attached to the right side of every window. 


Scroll box—rectangle that indicates the displayed portion of the 
contents and its relative position to the top and bottom of the total 
contents. The box covers a percentage of the scroll bar that is 
equivalent to the visible percentage of the total window contents. 
For example, if the scroll box covers half the scroll bar and is at the 
top, then the top half of the contents is visible. If it’s at the bottom, 
then the bottom half is visible. 


Up and down arrows—moves the scroll box up and down the scroll 
bar to scroll through the window’s contents. When a window is 
displayed at its default size, the up and down arrows are not visible; 
they appear and disappear as needed. 

To scroll through a window’s contents with a mouse: 
Click on the arrows to scroll up or down one line at a time. 


Click and hold an arrow to scroll through multiple lines. 


Drag the scroll box up or down the scroll bar. 


To scroll through a window’s contents with the keyboard: 


Press T and J to scroll up and down one line at a time. 


Press Page Up and Page Down to scroll up and down one window 
at a time. 


Press Home and End to scroll to the top and the bottom. 


8.4.9 Changing Window Display Formats 

Some windows can display data in several formats. These windows 
indicate the display format in parentheses next to the window title, 
such as “Control Registers (Decimal)”. For a list of windows with 
multiple display formats, see Table 8.2. 


You can open multiple copies of the same window containing the same 
data, each in a different format. For example, you can open four 
Program Memory windows, one each in hexadecimal, decimal, fixed- 
point, and disassembled format. 


Windows Formats 
Hexadecimal Decimal  Fixed-Pt. Disassembled 
Computational X X X 
Alternate Computational X X X 
DAGI1 X X 
DAG2 X X 
Program Control X X 
Control Registers X X 
SPORTO X X 
SPORT1 X X 
Data Memory X X X 
Program Memory X X X X 
Boot Memory X X X 
Command Window X X 
Port Display X X 


Table 8.2 Windows With Multiple Display Formats 


To change a window’s display format: 
1. Activate the window. 
2. Press Cntl-T to toggle the window format. 
or 
3. Select Toggle Window Format from the Display menu. 


Repeat this procedure until the window displays the contents in the 
desired format. 


8.4.10 Saving Window (.win) Files 

When you invoke the simulator, it uses a default window file 
(s2101_0.win, saved in the same directory as the simulator) to open 
and position the windows and set their display formats. You can 
modify the default .win file automatically when you exit the 
simulator or create new window files at any time during a simulator 
session. 


To modify the default .win file: 
Select Exit from the Quit menu. 
To save the current configuration to a window file: 
1. Select Save Window File from the File menu. 
A file selection window appears for you to enter a filename. 


2. Type in the filename and press Return. The .win extension is 
appended automatically when the file is saved. 


(Note: Window files only save the position and display format of the 
windows, they do not save the contents.) 


8.4.11. Loading Window (.win) Files 
You can loada .win file to restore a screen configuration to the 
simulator. 
Toloada .win file: 
1. Select Load Window File from the File menu. 
2. Type in the filename, then press Return. You do not need to type the 


.win extension. 


8.5 CHANGING THE COLOR OF SCREEN OBJECTS 


The software sets the default color of screen objects for the user 
interface. You can change the default colors to suit your taste. 


To change the color of screen objects: 
1. Select Color Attributes from the Display menu. 


The pop-up window of screen objects (Figure 8.3) appears showing 
you the color for each object. 


2. Select the screen object you want to change. Click with the mouse, or 
use the arrow keys, then press Return. 


A table of color combinations (foreground color on background 
color) appears. You can select steady or flashing colors. Notice that 
the current color combination is marked with square brackets. 


3. Select the color combination you want. Click with the mouse, or use 
the arrow keys then press Return. 


4. Repeat this procedure until the screen objects are the colors you 
want them. Then select Accept to implement the colors changes. 


To discard your color changes, select Cancel; to revert to the default 
color scheme, select Reset. 
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Figure 8.3 Screen Object Color Selection Window 


3.6 SAVING & PLAYING BACK KEYSTROKE FILES 


The simulator can record a sequence of mouse actions and keystrokes 
in a file and replay them later. This is useful if you want to repeat the 
same command sequence. 

To save a keystroke file: 


1. Select Start Keystroke Recording from the File menu. 


2. Type a filename in the pop-up window, then press Return. The 
.ksf extension is automatically appended to the filename. 


3. Enter the keystrokes and mouse actions. (A generic example follows 
this procedure.) 


4. Select Stop Keystroke Recording from the File menu. The keystroke file 
is saved under the supplied filename. 
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The following example shows you a typical keystroke and mouse 
sequence with comments to explain each step. The example loads a 
.win file, fills data memory with some data, and loads an executable 
file. 


Click on File display the File menu 

Click on Load Window File display the file selection pop-up 
window 

Type [filename] the name ofa .win file 

Press Return load the .win file 

Click on data memory window activate the data memory window 

Press Cntl-F display pop-up window for 
address range 

Type [starting address] the starting address 

Press Return highlight the ending address 

Type [ending address] the ending address 

Press Return set range and display the pattern 
window 

Type [memory pattern] the memory pattern 

Click on command window activate the command window 

Type load ‘program name’ the name of an . exe file 

Press Return load the .exe file 


To playback a keystroke file: 
1. Select the Playback Keystroke File from the File menu. 


2. Type the filename in the file selection pop-up window and press 
Return. You do not need the .ksf extension. 


The keystroke file is played back and the sequence is repeated. 


(Note: Keystroke files do not contain any window configuration 
information. To guarantee proper results, the first command in a 
keystroke file is often Load Window File. This opens the proper 
windows for the operation stored in the keystroke file.) 


8.7 GETTING HELP 


The simulator’s help screens provide on-line assistance during a 
simulator session. Help screens are context-sensitive; they provide 
information that is relevant to what you are currently doing. You can 
activate the help screens any time the simulator is not running. 


To active the help screens: 

Select Help from the menu bar, or press F1. 
The highlighted words in a help screen provide links to other topics. 
You click on a highlighted word (or use the arrow keys and press 
Return) to call up additional information related to that topic, or to 


navigate through the screens. 


When you're finished with the help screens, select Return To Simulator, 
or press Esc to exit the help screens and return to the simulator. 


8.8 EXITING & QUITTING 


There are two ways to leave the simulator and return to the operating 
system: exiting and quitting. 


To exit from the simulator and modify the default window file: 
1. Select Exit from the Quit menu. 


A pop-up window appears with a message asking if you really want 
to exit. 


2. Type “Y” (for yes), click on the button, or press the space bar to 
toggle the reply, then Press Return. 


Or 


3. To cancel, press Esc, or when the buttons displays “No”, press 
Return. 


This command modifies the default window file before returning you 
to the operating system. The new screen configuration appears the 
next time you run the simulator. 


User Interface 


To quit from the simulator: 
1. Select Quit from the Quit menu. 


A pop-up window appears with a message asking if you really want 
to quit. 


2. Type “Y” (for yes), click on the button, or press the space bar to 
toggle the reply, then Press Return. 


Or 


3. To cancel, press Esc, or when the buttons displays “No”, press 
Return. 


Registers & Memory 


9.1 OVERVIEW 


This chapter describes how to inspect and alter processor registers, 
memory locations, and stacks. This chapter also describes most of the 
windows that display the contents of these registers, memory locations, 
and stacks. Chapter 11, I/O Operations, describes the specific registers for 
the I/O interfaces (the serial ports, the host interface port, and the analog 
interface). The register operations described in this chapter also apply to 
the registers in Chapter 11 and to the registers maintained by the 
simulator software that are not actual processor registers. 


9.2 REGISTER OPERATIONS 


The simulator lets you view the contents of processor registers and, in 
most cases, change the contents directly. Table 9.1 (below) lists the 
windows dedicated to register displays. This chapter describes the 
registers and default formats for each window. The serial ports (SPORTs), 
the host interface port (HIP), and the analog interface have their own 
registers and windows, which are described in Chapter 11. 


Window Contents 

Computational Primary computational registers 
Alternate Computational Background computational registers 
DAG Computational Data address generator registers 
Program Control Program control registers 

Interrupt Interrupt control registers 

Status Processor status registers 

Control Processor control registers 

Flag Flag register 

PX Register 24-bit data transfer register 

CE Counter expired (for debugging only) 


Table 9.1 Windows Showing Registers 


9.2.1. Inspecting A Register 


You can inspect the contents of a register in two ways. First, you can 
display the window containing the register and read its value from the 
screen. Second, whether or not the register’s window is open, you can 
query the register’s value from the command window with the ? 
command (for more information, see “Evaluating Expressions With The ? 
Command” in Chapter 12). For example, when you type the command 

> ? ax0 

in the command window, the simulator responds with a message such as 
axQ = 0x002c 


in the command output window. 


9.2.2 Changing A Register 


You can change the contents of a register directly in the window 
displaying the register, or by entering a command in the command 
window. (The execution of your program, of course, also alters the 
contents of registers.) 

To change a register directly: 

1. Open the window containing the register. 

2. Move the cursor and highlight the field of the desired register, then 
type the new value. When you press Return, the new value replaces 
the old value. 

To change a register from the command window: 
Enter a command with the following form in the command window 


> register = expression 


where register is the name of a processor register and expression is the 
value you want to load into the register. 


For example, 
> mxO = Ox00ff 


puts the value OxOOFF in MXO. 


9.2.2.1 Undefined Registers 

Uninitialized registers contain an “undefined” value denoted by “uuuu.” 
During debugging, when the simulator reads an undefined register, it 
flags an error. Therefore, it may be useful to set a register back to the 
uninitialized state. The simulator includes the Undefine (U) command for 
this purpose. For example, to set the AR register to its undefined state, 


type 

> undefine ar 
or 

> WU ar 


in the command window. 


9.2.3 General Purpose Registers 

The simulator maintains four general purpose registers for storing data 
during simulation. These software registers, named HOLDERI, 
HOLDER2, HOLDERS, and HOLDER4, are not actual registers in ADSP- 
21xx processors. You can transfer data to or from one of these registers 
using the same methods described in Section 9.2.2, “Changing a Register.’ 
For example 


> holderl=ay0+my0 
stores the sum of the values in AYO and MYO in HOLDER!1. 


These registers can be used in break expressions, watch expressions, or 
general expressions. When you examine the contents of these registers 
with ? command, the data is displayed only in the command output 
window. 


J 


9.2.4 Computational Registers Windows 

The computational registers window (shown in Figure 9.1) displays the 
contents of the primary computational registers. It contains the values of 
the registers in the ALU, MAC, and shifter. These registers are as follows: 


ALU Registers 

AX0, AX1 X inputs (16 bits) 

AYO, AY1 Y inputs (16 bits) 

AR Results register (16 bits) 

AF Feedback register (16 bits) 

MAC Registers 

MX0, MX1 X inputs (16 bits) 

MYO, MY1 Y inputs (16 bits) 

MRO-MR2 Results registers (40 bits total, 16 bits in MRO, 16 bits in 
MR1, and 8 bits in MR2) 

Shifter Registers 

SRO, SR1 Results register (32 bits total, 16 bits in SRO, 16 bits in SR1) 

SI Input register (16 bits) 

SE Shifter exponent register (8 bits) 

SB Shifter block register (5 bits) 
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Computational Registers (Hexadecimal) 
active 
> UU AX1: uuu AR: wuuuu 
> UULULUL AY1: uuu AF: wuuuu 
> UUW MX1:° uuu 
> ULULLLLL M¥i: uuu MF: uuuu 
> ULLLULUL MR1i: uuu MR2: uu 
> ULULLLUL SR1i: uuu 
ULLULULLL SE: uu SB: uu 


ommand Window (Hex) 


13:48:59 


Figure 9.1 Computational Registers Window 
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The alternate computational register window displays the background 
computational registers and is identical to the window shown above. For 
more information about the registers, see the ADSP-2100 Family User's 
Manual. 


9.2.5 DAG Registers Window 


The DAG registers window (shown in Figure 9.2) shows the contents of 
the data address generator registers. The DAG registers are as follows: 


10-17 Index registers, contain actual addresses used to access data 
MO0-M7 Modify registers, used to post-modify the I registers 
LO-L7 Length registers, determine length of circular data buffers 


There are two DAGs, each containing three sets of 14-bit registers: 


DAGI DAG2 


Index Registers: 10-I3 14-I7 
Modify Registers: MO0-M3 M4-M7 
Length Registers: LO-L3 L4-L7 
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DAG Registers (Hexadecimal) 
> UU MA: uuu L@: uuUH 
> UULULU > LULL > UU 
> UULULL > UU > UU 
> UU > ULL > ULL 
- UUUL > ULL > UU 
> UULLL > UU : UU 
> UUULULLL > UULLLLUL > UULLU 
> UU > LULL > ULL 


ommand Window (Hex) 


13:69:38 


Figure 9.2 DAG Registers Window 


The DAG registers window can display data in hexadecimal or decimal 
format. Note that in the decimal display format, the I and L registers are 
displayed as 14-bit unsigned values, but the M registers are displayed as 
14-bit signed, twos complement values. You can change the current 
display format by pressing Ctrl-T. For a detailed description of the DAGs, 
see the ADSP-2100 Family User’s Manual. 


9.2.6 | Program Control Registers Window 


Figure 9.3 shows the program control registers window which includes 
the following registers: 


PC Program counter, points to next instruction to be executed 
CNTR Do loop counter, counts loop iterations 
CYCLE Cycle counter, counts the number of processor cycles executed 


PM_ADDR _ Last program memory address that was accessed 
DM_ADDR_ Last data memory address that was accessed 


For more information about the PC and CNTR registers, see the ADSP- 
2100 Family User’s Manual. The CYCLE, PM_ADDR, and DM_ADDR 
registers are not actual registers in and ADSP-21xx processor; the 
simulator provides these “registers” for convenience and to help debug 
programs. 
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Program Control (Hexadecim 
PC: 64666 
CNTR: 


ULULULLL 
CYCLE: alalalaiaialala) 
PM_ADDR: uuuu 
DM_ADDR: uuu 


ommand Window (Hex) 
> 


13:16:66 


Figure 9.3 Program Control Registers Window 


9.2.7. _—_ Interrupt Control Registers Window 


The interrupt control registers window (shown in Figure 9.4) contains the 
following registers: 


[REQ Pending interrupt requests 

IMASK Interrupt mask register, masks/enables individual interrupts 

ICNTL Interrupt control register, configures external interrupts as 
edge- or level-sensitive 

[PC Interrupt force/clear register, lets you force and clear edge- 


sensitive interrupts through software (not on ADSP-2100A) 
IREQ is not an actual processor register. It shows which interrupts are 
pending and is provided for convenience. The bits in IREQ correspond 
with the bits in IMASK. 


For more information about the IMASK, ICNTL, and IFC registers, see the 
ADSP-2100 Family User's Manual. 
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ommand Window (CHex) 


13:11:58 


Figure 9.4 Interrupt Control Registers Window 


9.2.8 Status Registers Window 

The status registers window (shown in Figure 9.5) displays the values 
stored in each status register and the state of the individual bits. The 
status register window contains the following registers: 


ASTAT Arithmetic status register, displays the status generated by 
the processor’s computational blocks (8 bits) 

SSTAT Stack status register, displays the status of the processor’s 
four stacks (8 bits) 

MSTAT Mode status register, determines the processor’s operating 
mode (7 bits) 


For more information about the status registers, see the ADSP-2100 Family 
User's Manual. 
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Status Registers 
55 MSTAT: 


RBANK : 
BIT_R: 
ALUOY : 
ARSAT: 
MACRP : 
T_ENA: 
G_ENA: 


ommand Window CHex) 
| I 


13:11:12 
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SS_E 
$S_0 
LS_E 
LS_O 


Figure 9.5 Status Registers Window 


9.2.9 Control Registers Window 

The control registers window (shown in Figure 9.6) displays the contents 
of the processor’s memory-mapped control registers. The bits in this 
window are defined as follows: 


BF Boot force bit 

BPAGE Boot page select (3 bits) 

BWAIT Boot wait states (3 bits) 

BMODE Boot mode pin (on ADSP-2111 and ADSP-21msp5x only) 
SPEO SPORTO enable bit 

SPE SPORT1 enable bit 

SCNF1 SPORT1 configure bit 

ROMENABLE _ Enables 2K of on-chip ROM (ADSP-21msp51/56 only) 
DWAIT0-4 Data memory wait states (3 bits for each) 

PWAIT Program memory wait states (3 bits) 

TSCALE Timer scaling register (8 bits) 

TPERIOD Timer period register (16 bits) 

TCOUNT Timer counter register (16 bits) 
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Control Registers (Decimal) 
SPE: 6 DWAIT@: 7 DWAITS: 7 TSCALE: uuu 
SPE1: 6 DWAIT1: 7 DWAIT4: 7? TPERIOD: uuu 
SCNF1i: 1 DWAIT2Z: 7 PWAIT: 7? TCOUNT: uuu 


ROMENABLE: u 


ommand Window CHex) 


Figure 9.6 Control Registers Window 


13:13:17 
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e BF, BPAGE, BWAIT, SPEO, SPE1, SCNF1, and PWAIT are located in the 
System Control Register at DM(0x3FFF). 


e ROMENABLE and DWAIT0-DWAIT4 are located in the Data Memory 
Wait State Control Register at DM(Ox3FFE). 


The ADSP-2100 Family User’s Manual contains complete descriptions of 
these bits and registers. 


9.2.10 Flag Register Window 

The flag register window (shown in Figure 9.7) displays the flag pins. All 
ADSP-21xx family processors (except the ADSP-2100) have a flag-in (FD) 
and a flag-out (FO) pin. The ADSP-2111 and ADSP-21msp50 have three 
additional flag output pins: FLO, FL1, and FL2. The flag pins are defined 
as follows: 


FI Flag-in pin, used to control conditional program 
branching for JUMP and CALL instructions 


FO and FO-F2 ~—‘- Flag-output pins, used for software to signal events or 
conditions to external devices, such as the HIP 


For additional information about the flag pins, see the ADSP-2100 Family 
User’s Manual. 


9.2.11 PX Register Window 

The PX register window (also shown in Figure 9.7) displays the contents 
of the 8-bit PX register. The PX register is used for the least significant byte 
of 24-bit data transfers to and from program memory. 


For additional information about the PX register and 24-bit data transfers, 
see the ADSP-2100 Family User’s Manual. 


9.2.12 CE Window 

The counter expired (CE) value is used as a loop termination condition in 
Do Until loops. The simulator’s CE window (shown in Figure 9.7) reports 
the state of this bit, which is generated by the counter expired logic of the 
ADSP-21xx chip. 


For additional information, see the ADSP-2100 Family User’s Manual. 
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FI: 6 : wu 
FL@: 1 FLi: 1 FL2: 1 


PX Register 
| PX: uu | 
CE Register 
| CE: wu | 


ommand Window (CHex) 


13:16:36 


Figure 9.7 Flags, PX, & CE Windows 


9.2.13 SPORTO, SPORT1 Registers Windows 


The serial ports’ memory-mapped control registers are displayed in two 
register windows, one for each SPORT (Figure 9.8, on page 9-13, shows 
the SPORT0 registers window). The information displayed in these 
windows is: 


SLEN -Serial length of the data word (4 bits) 

1 Alp die -Data format (2 bits) 

ISCLK -Internal serial clock enable bit, determines if the 
processor generates the SCLK signal or receives an 
external SCLK 

IRFS, ITFS -Internal receive (IRFS) and transmit (ITFS) frame 
sync bits 

RFSR, TFSR -Receive (RFSR) and transmit (TFSR) frame sync 


required bits, determines if a sync bit is necessary 
only once to start communications, or if a sync bit 
is necessary with each data word 

RFSW, TFSW -Receive (RFSW) and transmit (TFSW) frame synch 
width bits, enables the normal or alternate framing 
modes 
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INVRES, INVTFS 


SCLKDIV 
RFSDIV 


RBUF, TBUF 


RIREG, RMREG 
TIREG, TMREG 


MCREO, MCRE1 


MCTEO, MCTE1 


-Inverted receive (INVRFS) and transmit (INVTFS) 
frame sync enable bits, determines if the active 
frame sync bit is high or low when multichannel 
mode is enabled 

-Serial clock divisor register (16 bits), sets internal 
clock frequency 

-Receive frame sync divisor register (16 bits), sets 
receive frame sync frequency 

-Receive (RBUF) and transmit (TBUF) autobuffering 
enable bits, lets the processor receive or transmit an 
entire block of serial data before an interrupt is 
generated; when disabled, an interrupt is 
generated for each data word 

-Receive autobuffering I (RIREG, 3 bits) and M 
(RMREG, 2 bits) registers 

-Transmit autobuffering I (TIREG, 3 bits) and M 
(TMREG, 2 bits) registers 

-(SPORTO) Multichannel receive word enable 
registers (16 bits each), MCREO lets words 0-15 be 
received and MCRE1 lets words 16-31 be received 
-(SPORTO) Multichannel transmit word enable 
registers (16 bits each), MCTEO lets words 0-15 be 
transmitted and MCTE1 lets words 16-31 be 
transmitted 

-(SPORTO) Multichannel enable bit, enables and 
disables multichannel mode 

-(SPORTO) Multichannel frame delay (4 bits), 
determines the number of serial clock cycles 
between the frame sync bit and the first data bit 
-Receive data register (16 bits) 

-Transmit data register (16 bits) 


e SLEN, DTYPE, ISCLK, IRFS, TRFS, RFSR, TFSR, RFSW, TFSW, INVRES, 
INVTFS, MCE, and MCED are located in the SPORTO Control Register at 
DM(0x3FF6). FO replaces MCE in the SPORT1 Control Register at 


DM(0x3FF2). 


e RBUF, TBUF, RIREG, RMREG, TIREG, and TMREG are located in the 
SPORTO Autobuffer Control Register at DM(Ox3FF3) and the SPORT1 
Autobuffer Control Register at DM(Ox3FEF). 


For more information on simulating serial port I/O, see Chapter 11, I/O 
Operations. For a detailed description of the SPORTs, see the ADSP-2100 


Family User’s Manual. 
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Sport 6 Registers (Hexadecimal) 
DTYPE6#: @ ISCLK#: 6 
RFSR#: 6 RFSWA: 6 INYVRFS@: 6 # 


TFSR@: @ TFSWH: @ INUVTFS@: 6 # 
> UU RFSDIV@: uuu i 
RIREG#: u RMREGS: u 
TIREG6#: u TMREG#H: u 
> UUULULLL MCTE#: uuu MCE#: 6 
> UULLLLL MCTE1: uuu MCFD: @ 
UULLLUL TX68: uuu 


ommand Window (Hex) 


13:17:58 


Figure 9.8 SPORTO Registers Window 


9.2.14 HIP Registers Window (ADSP-2111, ADSP-21msp50) 

The ADSP-2111 and ADSP-21msp50 simulators let you simulate host 
interface port (HIP) operation. The registers used during HIP operations 
(shown in Figure 9.9, which can be found on the next page) are defined 
below: 


HDRO-HDR5 - HIP data registers (16 bits each) 
HMASK - HIP interrupt mask register (16 bits) 
HSR6-HSR7 - HIP status registers (16 bits each), HSR6 shows 


which HDRs are written to by the host and which 
HDRs are written to by the ADSP-21xx (also shown 
in HSR7); HSR7 also shows the overwrite mode and 
software reset bits 


HIP OVWRITE - Overwrite mode bit 

HIP RESET - Software reset bit 

msp50 (or 2111) - Transfer status of the HDRs from the ADSP-21xx 
Host - Transfer status of the HDRs from the host 


BFile 


Register 


Memory Stacks 


Command Execution 


Hip Registers (Hex) 


Type CTRL_R to read values from hip 
Enter data to write values to hip 


HDR#_EDIT: 
HDR1i_EDIT: 
HDR2_EDIT: 
HDR3_EDIT: 
HDR4_EDIT: 
HDRS_EDIT: 


HDR#_HOST: 
HDR1_HOST: 
HDR2_HOST: 
HDR3_HOST: 
HDR4_HOST: 
HDRS_HOST: 


Display Misc 


HMASK: 6666 


--- STATUS --- 
HSR6: 88aa 

HSR7: @ag@ 

HIP_OUWRITE: 6001 
HIP_RESET: 6008 


13:26:25 


Figure 9.9 HIP Registers Window 


By convention, the simulator calls a data transfer from the host a write 
and a transfer to the host a read; in other words, “write” and “read” are 
from the host’s perspective. 


The top portion of the HIP registers window is divided into three fields: 
the Edit field, the 21xx field (representing either the ADSP-2111 or the 
ADSP-21msp50), and the Host field. The six HDRs appear in each of the 
three fields. 


The middle portion of the HIP registers window (under STATUS) 
monitors the HSRs. Changes to the Host and 21xx fields in the top portion 
of the window are reflected by a change in the HSR values. This portion 
also displays the HIP_RESET and HIP_OVWRITE bits. 


The bottom portion of the HIP registers window is a table that shows the 
transfer status of each HDR. The columns labeled 0 123 45 refer to the 
HDRs. The row labeled msp50 (or 2111) indicate the status of transfers 
from the ADSP-21xx, and the row labeled HOST indicate the status of 
transfers from the host. An “e” indicates that the HDR is empty (has been 
read since the last update to this HDR). An “f” indicates that the HDR is 
full (has not been read since the last update to this HDR). 
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For more information on simulating HIP I/O, see Chapter 11, I/O 
Operations. For a detailed description of the HIP, see the ADSP-2100 
Family User’s Manual. 


9.2.15 Analog Interface Registers Window (ADSP-21msp50) 


The analog interface registers window (shown in Figure 9.10, on page 
9-16) displays the control register bits and data registers of the analog 
interface as well as the powerdown control bits. These registers are all 
memory-mapped, and may also be modified in the data memory window. 
The fields in the analog interface registers window are defined as follows: 


ADCRECV _ -Receive (ADC) data register (16 bits) 
DACTRAN _ -Transmit (DAC) data register (16 bits) 


ARBUF -Receive autobuffer enable bit 

ATBUF -Transmit autobuffer enable bit 

ARIREG -Receive autobuffer I register select bits (3 bits), sets up the 
index register for circular buffering 

ATIREG -Transmit autobuffer I register select bits (3 bits), sets up 


the index register for circular buffering 
ARMREG -Receive autobuffer M register select bits (2 bits), sets up 
the modify register for circular buffering 


ATMREG -Transmit autobuffer M register select bits (2 bits), sets up 
the modify register for circular buffering 
PUCR -Powerup context reset enable bit, determines if stacks are 


cleared when processor exits the powerdown interrupt (if 
set to 1, stacks are cleared) 

PDFORCE -Powerdown force bit, forces the processor to vector to the 
powerdown interrupt 


The following bits do not affect the operation of the simulator. They are for 
informational display only. 


XTALDELAY -Cycle delay after exiting powerdown 
XTALDIS -XTAL pin disable, disables the XTAL pin during 


powerdown 
IPS -ADC input preamp select bit 
IMS -ADC input mux select bit 
OG0-OG2 -DAC output gain select (3 bits) 
APWD -Analog interface powerdown bits (2 bits) 
ADBY -ADC high-pass filter bypass bit 
DABY -DAC high-pass filter bypass bit 


For more information, see Chapter 11, I/O Operations. For a detailed 
description of the analog interface and powerdown control bits, see the 
ADSP-2100 Family User’s Manual. 


9.3 STACK OPERATIONS 


The ADSP-21xx processors maintain four stacks. The simulator displays 
these stacks in four separate windows, shown in Figure 9.11. These 
windows are opened from the Stack menu. 


Loop stack - Loop address stack, saves the last instruction address 
and termination condition of up to four nested loops 
(18 bits wide, 4 locations deep) 

Counter stack - Loop counter stack, saves the loop count of up to four 
nested loops (14 bits wide, 4 locations deep) 

PC stack - Program counter stack, saves the return addresses when 
CALL and DO UNTIL instructions are executed (14 bits 
wide, 16 locations deep) 
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Analog Interface (Hex) 
DAC TRAN -uuuu 
ATBUF: @ 
ATIREG: u 
ATMREG: u 
PDFORCE: @ 
XTALDIS: @ 
IMS : 4 


DABY : 


ommand Window (Hex) 


13:29:36 


Figure 9.10 Analog Interface Registers Window 
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Counter Stack Loop Stack Status Stack PC Stack 
UU TUE uUuUUUUU uuu 
UUULULULL UWULULULLL UUULULLLULLLL 2 UUULLL 
uuu UUW UUW “ uuuw 
uuuUU uuu UUW ei uuu 

UUW ie UU 
UU a UU 
uuu E uuu 
UUULULULL 4 uuu 
UUW fe UU 
9666364 i uuu 
UULULULULLLL z UU 
UUW UU 
UU 

uuu 

UU 

ommand Window (Hex) uuu 


13:36:57 


Figure 9.11 Stack Windows 


Status stack — - Processor status stack, saves the processor’s status as 
shown in the ASTAT, MSTAT, and IMASK registers; 
width and depth depends on the processor: 


e ADSP-2101 status stack is 21 bits wide, 7 locations deep 
e ADSP-2105 status stack is 21 bits wide, 7 locations deep 
e ADSP-2115 status stack is 21 bits wide, 7 locations deep 
e ADSP-2111 status stack is 23 bits wide, 9 locations deep 
e ADSP-21msp50 status stack is 25 bits wide, 12 locations deep 


For detailed information about the stacks, see the ADSP-2100 Family User's 
Manual. 
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9.3.1 


Changing A Stack Value 
You change stack values the same way you change registers, either by 
typing a new value directly in the stack window or by entering a 
command in the command window. Table 9.2 displays the syntax used to 
represent the stack locations. 


To change a stack value directly: 


1. Open the window containing the stack. 


2. Move the cursor and highlight the field of the desired stack 
location, then type the new value. When you press Return, the new 


value replaces the old value. 


CNTRO 
CNTR1 
CNTR2 
CNTR3 


Table 9.2 Stack Location Syntax 


LOOPO 
LOOPI1 
LOOP2 
LOOP3 


STATUSO 
STATUS1 
STATUS2 
STATUS3 
STATUS4 
STATUS5 
STATUS6 
STATUS7 
STATUS8 
STATUS9 
STATUS10 
STATUSI11 


PCO 
PCi 
PC2 


To change a stack value from the command window, enter a command 
with the following form in the command window: 


>stacklocation= expression 


where stacklocation is the specific stack location (from Table 9.2) and 
expression is the value you want to write. 


For example, 
>cntrO = QxX0A 


changes the value at the top of the counter stack to 0x0A. 


9.4 MEMORY OPERATIONS 


This section describes how to inspect and change the contents of any 
memory location and save the contents to files for later analysis. 


9.4.1. Specifying A Memory Address 

When you must specify an address in a simulator command, you can use 

either the numeric address itself or the equivalent symbol. For example, if 
the label startup is equivalent to PM address 0x0A, you could enter either 


> go pm(0Ox0A) 

or 

> go pm(startup) 
and get the same result. 


9.4.2 Inspecting A Memory Location 

There are two ways to inspect a memory location. First, you can open and 
activate the memory window and display the desired location. Second, 
you can directly query the contents of any memory location from the 
command window. 
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For the first method, once the window is active, you can change the range 
of displayed addresses with the following options: 


e Scroll to the address 


Use T, 1, Page Up, Page Down, Home, and End keys to scroll or jump 
through memory. Use T and J to scroll through memory one line at a 
time. To move more quickly through memory, use Page Up and Page 
Down to advance one window at a time. To jump to the first address in 
memory, press Home; to jump to the last address, press End. 


¢ Go To Address command 


You can execute this command with the mouse or from the keyboard. 
To use the mouse, select Go To Address from the Memory menu. If you 
want to use the keyboard, press Ctrl-G. In the resulting pop-up address 
window, enter the desired address or symbol name (suchas 001a or 
START ). Because only one memory window can be active, you do not 
need to specify PM, DM, or BM. When you press Return, the first line of 
the window displays the specified address. 


For the second method, you can query the memory contents from the 
command window with the ? command (for more information, see 
“Evaluating Expressions With The ? Command” in Chapter 12). For 
example, when you type the command 

> ? dm(1) 

in the command window, the simulator responds with a statement such as 


dm(Qx01) = Ox002c 


in the command output window. You can query program (pm), data (dm), 
or boot (boot) memory. 


9.4.3. Writing Memory Contents To A File 
Use the Dump Memory (DUMP) command to save the contents of data, 


program, or boot memory to a file. There are two methods you can use: 
enter the command directly from an open and active memory window, or, 
regardless of whether or not the memory window is open, issue the 
command from the command window. 
To save memory contents from an active memory window: 
1. Select Dump Memory from the Memory menu 
or 
press Ctrl-D 
to display the address range pop-up window. 
2. Enter the starting and ending address (pressing Return after each), 
to complete the address range and display the filename pop-up 


window. 


3. Enter a filename (the .DAT extension is optional), then press Return. 
The simulator automatically creates the file and writes the data to it. 


To save memory contents from the command window: 
Enter a command of the following form in the command window: 
> dump address/range >’ filename’ 


where address is the starting address, range is the number of memory 
locations you want to save, and filename is the output file. 


This command, for example, 
> dump dm(0x0000)/5 = *output.dat’ 


creates a file called “output.dat” and saves the contents of the first five 
data memory locations. 


The data is saved to a file in the same data format (hexadecimal or 
decimal) as the format of the command window when the command was 
originated. 


9.4.4 Locating Symbols & Values 

You can use the ? command, in the command window, to locate symbols 
as well as evaluate expressions. For more information, see “Evaluating 
Expressions With The ? Command” in Chapter 12. The form of the 
command is 


> 2? symbol 


where symbol is any symbol defined in your program. For example, to find 
the label routine3, if you enter the following command in the command 
window: 


> 2? routines 


The simulator’s response in the command output window might look like 
this: 


routine3=pm (0x37) 


meaning that label routine3 is located at program memory address 
0x0037. 


Remember that labels are case-sensitive only when you invoke the 
simulator with its -c switch. If, under this circumstance, you enter 
“ROUTINE3” when the actual label is “routine”, it will not be found. 


The Find (F) command finds numeric values in a given memory range. 
The numeric value can be a data value or an opcode. If the value is an 
opcode, you can specify it as a number or an assembly language 
instruction. The Find command automatically assembles instructions to 
their opcodes. The syntax of the Find command is 


> find address|range expression 

or 

> £ address|range expression 

where address or range is any valid address or address range specifier and 
expression is any valid expression, including instructions and simple 


numeric values. The semicolon that terminates an instruction is optional 
with the Find command. 


This command searches for an exact numeric match, not a partial match. 
For example, to locate the instruction 


dm (BUFFER) =ax0 

Enter the following command in the command window: 
> find pm(0)/100 dm(BUFFER) =ax0 

or 

> £ pm(0)/100 dm(BUFFER) =ax0 


The command locates the address in program memory and the simulator 
responds with something like: 


pm(100) 90000 dm(BUFFER) =ax0 


Which means that this particular instruction is located at program 
memory address 0x0100. 


To find an instruction, you must give the complete instruction (semicolon 
optional). If a label is part of the instruction, it must be included. If the 
label was read from boot memory, the boot page identifier that is 
automatically appended to the label must be specified as well. 

The best way to locate a symbol is to use the ? command. It can be case- 
sensitive and can discriminate between data, program and boot memory 
when it searches for a symbol. The best way to find a data value or specific 
opcode is to use the Find command. 


9.4.5 Plotting The Contents Of Memory 


A useful way to inspect memory is with the Plot (PL) command. This 
command plots up to 640 program or data memory locations on the x axis, 
with the data value of the location on the y axis, and displays the results. 
The syntax of the Plot command is 


> plot range decimation 


where range is an address range and decimation is an integer value (or 
expression) indicating which memory locations within the range to select 
for plotting. For data that is interleaved, for example, you would select 
every other word by setting decimation to 2, as in 


> plot dm(0x100)/0Oxff 2 
Or 
> pl dm(0x100) /0xff 2 


Since no more than 640 points total can be graphed, the length of the 
range divided by the decimation factor must not exceed 640. 


After you enter the command, the windows disappear and the plot is 
displayed. Type Exit to return to the previous display. 


Note: Do not use the Plot command in a keystroke file. 


9.4.6 Changing A Memory Location 

You can directly alter the contents of memory in two ways. First, you can 
change the contents of a location from an open and active memory 
window. Second, you can change the contents of any location from the 
command window. 


Regardless of the method you choose, there is a differences between 
changing data memory and program or boot memory. When you enter a 
new value in the data memory window, that value is a number; when you 
are enter a new value in the program or boot memory window, that value 
is an instruction. 


To change the contents of a location from the active memory window: 
1. Highlight the location you want to change. 


2. Type the new value, then press Return. The simulator 
automatically replaces the value. 


Note: You must enter the value in the correct window format. For 
example, you cannot enter a decimal number into the program memory 
window when the window’s format is “disassembled”; you must enter a 
legal instruction. 


To change the contents of a location from the command window, use the 
Fill command in the form 


> fill address expression 
where address is the address you want to change and expression is the value 
you want to write into the specified location. Symbols (variable names or 


labels) are acceptable addresses. 


For example, to write a zero into data memory address 200, the command 
is 


> fill dm(200) 0 


Likewise, to write the opcode for NOP (which is all zeroes) into the 
program memory location labeled rst_strt, the command is 


> fill pm(rst_strt) 0 


You can also use the Fill command to fill multiple memory locations with 
the same value. Use the command in the form 


> fill start_address/range expression 
or 


> fill start_address,end_address expression 


where start_address is any starting address in memory and range is the 
number of locations to be filled, or end_address is the ending address. For 
example, to fill data memory addresses 0x3800 to 0x3805 with the value 0, 
use the command 


> fill dm(0x3800)/5 0 
Or 
> £111 dm(0x3800),dm(0x3805) 0 


Note: When you use the Fill command to enter opcodes into program or 
boot memory, you must enter a number (in the correct format) in the 
command window; you cannot enter an a disassembled instruction, such 
as axO = ar. 


9.4.6.1 Reading Memory Contents From A File 


You can enter the contents of a file into a memory range with a variation 
of the Fill command. Use the form 


> fill start_address <‘filename’ 


where start_address is any address in memory and filename is the name of a 
file to be read from. This file must be in the data file format (.DAT) 
described in Appendix F. The size of the file determines the amount of 
memory needed; the file is read until the end. If the file is too large, 
unpredictable results occur. 


9.4.6.2 Changing Program Instructions 
The command equivalent for directly entering an instruction into program 
or boot memory is the Assemble (A) command. The syntax is 


> assemble address instruction 

or 

> a address instruction 

where address specifies a location in program memory and instruction is a 
valid instruction (not opcode). The semicolon in the instruction is 
optional; the simulator correctly assembles the instruction whether you 


enter the semicolon or not. Any change is immediately displayed in the 
affected memory window, if open. 


For example, to change the instruction in program memory address 2 to 
the NOP instruction, enter 


> assemble pm(2) nop 

or 

> a pm(2) nop 

This is equivalent to: 

> fill pm(2) 0 

since NOP assembles to all zeros. 


9.4.6.3 Undefined Memory Locations 

Uninitialized memory locations have the value “undefined.” The 
simulator flags a read of undefined memory as an error, so it can be useful 
to set a memory location back to an uninitialized state. The Undefine (U) 
command, entered in the command window, accomplishes this. You must 
specify the address (individual address or address range). For example, 
the command to undefine the first sixteen data memory addresses is: 


> undefine dm(0x0)/16 
Or 
> u adam(0x0)/16 


9.4.6.4 Viewing & Adding Symbols 


The symbol windows (such as the program memory symbol window 
shown in Figure 9.12, which can be found on the next page) display a list 
of all currently defined symbols and their corresponding values. You can 
display symbols numerically or alphabetically. The information in this 
window is taken from the symbol table in your .SYM file and the port 
declarations in your .ACH file. 


Symbol windows are opened from the memory menu. For example, 
to open an alphabetic program memory symbol display, select 
Symbol Display (Alpha), under Program Memory Display in the 
Memory menu. 
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Figure 9.12 Program Memory Symbol Window 
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The Addsymbol + (ASYM +) command adds a symbol (program label or 
variable/buffer name) to your program at a specified address. The symbol 
and its corresponding address are added to the simulator’s symbol table. 
This command takes the following form: 


> addsymbol + symbol address 


To create a new symbol, you must give a unique symbol name and specify 
the address in the form DM(addr), PM(addr), or BOOT(addr). For 
example, if the command | 


> addsymbol + routine3 pm(55) 


were given, program memory location 55 would be assigned the label 
routine3. 


You may also use the Addsymbol command to create another occurrence 
of an existing symbol or to assign a memory location another symbol. If 
the given symbol already exists at another address, both the existing and 
new addresses are associated with the symbol. If the given address is 
already defined as a symbol, the location is associated with both the old 
and new symbols in the symbol table. 


When you quit the simulator, any symbols added with the Addsymbol + 
command are lost—they cannot be saved. If you want to use these 
symbols again, add the Addsymbol command to your startup keystroke 
file. 


9.4.7 Program Memory Window 

Program memory is 24 bits wide and spans from address 0x0000 through 
Ox3FFF. Program memory is displayed in the program memory window 
(shown in Figure 9.13, on the following page). 


To the left of each address is a four-letter code which indicates the 
following: 


TorE Internal or external memory 
RAM or ROM located in RAM or ROM 


The contents of this window can be displayed in hexadecimal, decimal, 
1.15 fixed point, and disassembled formats. To change the data display 
format select Toggle Window Format from the Misc menu, or press Ctrl-T 
from an active memory window. 


9.4.8 — Instruction Cache Window (ADSP-2100 Only) 

The cache window shows the contents of the ADSP-2100’s internal 
instruction cache. The cache holds up to 16 instructions at one time. Each 
cache location displays the assembly language instruction it contains as 
well as the instruction’s address in program memory. 


The cache is empty until any code is executed by the simulator. If a JUMP 
instruction occurs which jumps far enough to invalidate the contents of 
the cache, the display is cleared. A chip reset (CR) also clears the cache. An 
example of the cache window is shown in Figure 9.14, which can be found 
on page 9-31. 
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Figure 9.13 Program Memory Window 


9.4.9 Data Memory Window 

Data memory is 16 bits wide and spans from address 0x0000 through 
Ox3FFF. The data memory window shows the numeric contents of data 
memory and any symbols defined for data structures. Figure 9.15 shows 
the default configuration of this window; you cannot change this 
configuration. To the left of each address is a four-character code which 
indicates the following: 


TorE Internal or external memory 
RAM or ROM RAM or ROM 


Data memory can be displayed in hexadecimal, decimal, and 1.15 fixed 
point formats. To change the data display format select Toggle Window 
Format from the Misc menu, or press Ctrl-T from an active memory 
window. 
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Figure 9.14 Cache Window (ADSP-2100 Only) 
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Figure 9.15 Data Memory Window 
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9.4.10 Boot Memory Window 


The boot memory window displays the contents of boot memory. Figure 
9.16 shows disassembled source code by address in boot memory. The 
window can contain the entire 16K of boot memory, from boot page 0 to 
page 7 (0x0000-0x3FFF). In the simulator, boot pages are always divided 
on 2K boundaries. The four-letter code to left of the window indicates the 
following: 


ROM Boot memory is usually ROM 
0-7 Specifies boot page 0 through 7 


The simulator does not support byte addressing in boot memory directly, 
nor does it show the extra bytes added to pad each instruction or data 
word for PROM alignment purposes. Only the PROM Splitter determines 
byte addresses. 


Boot memory can be displayed in hexadecimal, decimal, and 
disassembled formats. To change the data display format select Toggle 
Window Format from the Misc menu, or press Ctrl-T from an active 
memory window. 
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Figure 9.16 Boot Memory Window 
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10.1 OVERVIEW - 


This chapter describes operations for setting up and running a 
simulation of your DSP system. Setup functions include: 


e Loading memory with the program to be simulated and the necessary 
data, and 
¢ Configuring simulated processor inputs such as interrupts. 


Control functions include starting and stopping the execution of a 
program and resetting the simulated processor. Debugging functions 
include 


e Setting breakpoints and watchpoints, 

e Tracing processor bus activity, and 

e Creating a profile of the time spent executing various parts of your 
program. 


10.2 | LOADING AN EXECUTABLE PROGRAM 


The .EXE file produced by the linker is your executable program. To 
load this program into the simulator, 


-Select Load Executable File from the File menu (see Figure 10.1, on the 
following page). 


-Enter the name of your .EXE file (without the .EXE extension) in the 
pop-up window that appears and press Return. You must specify 
the full path of the file if it is not in the current directory (the 
directory from which you invoked the simulator). 
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Figure 10.1 File Menu 


Another way to load your executable file is with the Load (L) 
command, given in the command window: 


> load ‘filename’ 
or 


> 1 *filename’ 


The simulator actually loads both the .EXE file and the SYM symbol 
table file produced by the linker. The SYM file lets the simulator 
accept symbolic references to data variables, data buffers, and program 
labels. If the simulator cannot find the symbol table file, it displays a 
message and continues. Without the .SYM file, however, labels and 
variable names do not appear in simulator windows, only addresses, 
and you cannot use symbols to reference memory locations. 
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If you want to load your executable file without its symbol table, give 
the filename with the .EXE extension. For example, if you enter 


> load “TtEtE" 


the simulator loads both ditfft.exe and ditfft.sym. But if you 
enter 


> 1 *aALETEt.exe’ 
the simulator loads only ditfft.exe. 


When you load an .EXE file, the simulator also automatically initializes 
data buffers and variables according to the .[NIT directives in the 
source code. The simulator initializes buffers in any region of memory, 
whether internal, external, RAM or ROM; this simplifies simulator- 
based debugging. However, in an actual system, your program must 
initialize RAM buffers and ROM must be preprogrammed. A 
simulated boot load of internal program memory operates exactly as in 
an actual system and does not initialize data buffers. 


10.3. LOADING A SYMBOL TABLE FILE 


As an alternative to loading the symbol table along with the executable 
program, you can load just a symbol table file. The Loadsymbols (LS) 
command loads a .SYM symbol table file, completely replacing any 
existing symbol table (all current symbols are deleted). You can use 
this command to load a customized symbol table or one that has a 
main filename that is different from the executable’s filename. The 
Loadsymbols command affects only symbol definitions, not the 
executable code. 


This command must be entered in the simulator’s command window, 
with the following syntax: 


> loadsymbols ‘filename’ 
or 


> ls ‘filename’ 
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The .SYM extension is assumed and need not be given. The file must 
have the proper format for a linker-generated .SYM file as described in 
Appendix B, File Formats. 


10.4 LOADING A BOOT PROM FILE 

You can load the boot PROM image file (.BNM file) produced by the 
PROM Splitter. To do this, enter the Loadrom (LR) command in the 
command window: 


> loadrom ‘filename’ 
or 
> ler “fitename 


The filename given specifies a boot image file produced by the PROM 
Splitter. It is not necessary to include the .BNM extension; it is 
assumed. The Loadrom command initializes boot memory only, not 
program or data memory. Unlike the Load command, it does not 
initialize data variables or read in the symbol table. 


One reason to load the .BNM file rather than the .EXE file is to test the 
results of the boot loader operation implemented by the PROM 
Splitter. For more information on the boot loader, see Chapter 5, 
PROM Splitter. If you have not used the boot loader option, there 
should be no difference in the contents of boot memory whether 
loaded from the .EXE file or from the .BNM file. 


10.5 |= BOOTING THROUGH THE HOST INTERFACE PORT 


The Hipboot (HB) command lets you simulate boot loading of internal 
program memory through the host interface port (HIP) of the ADSP- 
2111 or ADSP-21msp50. You can create a HIP boot file (HIP) using the 
HIP Splitter utility program of the development software. The file 
must be Motorola S record format. 


The Hipboot command, given in the command window, reads a .HIP 
file into the simulator: 


> hipboot ‘filename’ 
or 
> hb ‘filename’ 


The filename given specifies a HIP boot file produced by the HIP 
Splitter. It is not necessary to include the .HIP extension; it is assumed. 


In actual hardware, the processor’s BMODE pin must be tied high to 
cause booting through the HIP. To simulate HIP booting, you must 
first set the BMODE pin to 1. (BMODE is displayed in the control 
registers window of the ADSP-2111 Simulator and ADSP-21msp50 
Simulator). 


Use the following two commands set up the simulator for HIP booting: 


> hipboot < ‘filename’ load HIP file 
> bmode=1 set BMODE pin for HIP booting 


Alternatively, you can set BMODE to 1 directly in the control registers 
window. To cause the simulator to perform the HIP boot, you can 
either enter a chip reset (CR) command or set the boot force (BF) bit in 
the control registers window. 


10.6 SIMULATING INTERRUPTS & OTHER INPUT SIGNALS 


Processor inputs such as externally generated interrupts can be 
simulated, occurring at selected time intervals. To open the interrupt 
timing window and set up a processor interrupt signal before running 
your program, 


-Select Interrupt Timing from the Misc menu (see Figure 10.2, which 
can be found on the following page). 


-Enter values for the MAX, MIN, and OFFSET parameters of IRQO, 
IRQ1, IRQ2, and IRQ3 (ADSP-2100 only). 


10-5 


File Register Memory Stacks Command Execution Display Help Quit 


Chip Reset 
Defaults 

Express ions 

Trace 

Prof ile 

About Simulator.. 
C-Debugger (CBUG) 


ommand Window (CHex) 
P | 


14:36:61 


Figure 10.2 Misc Menu 


The interrupt timing window of the ADSP-2101 Simulator is shown in 
Figure 10.3, which can be found on page 10-9. The MAX, MIN, and 
OFFSET parameters are defined as follows: 


MAX Minimum interval between occurrences of interrupt signal, 
in instruction cycles. 


MIN Maximum interval between occurrences of interrupt signal, 
in instruction cycles (default=MIN setting). 


OFFSET Number of instruction cycles before first interrupt is 
generated (default=0). 


The selected signal is generated at a random interval of at least MIN 
and at most MAX cycles. To cause an interrupt to occur at regular 
intervals, set MIN equal to MAX; otherwise the interrupt will occur at 
random times. 
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OFFSET specifies a delay before the signal is generated the first time. 
The MIN, MAX, and OFFSET values can be non-integer (e.g., 7.25). A 
non-integer value simulates an interrupt occurring in the middle of a 
processor cycle. If no value is chosen for MAX, it is set to the same 
value as MIN. If no value is chosen for OFFSET, it is set to zero. 


Another way to set up interrupts is with the Interrupt (I) command, 
given in the command window: 


> interrupt sig min [max] [OFFSET offset] 
or 
> 1 sig min [max] [OFFSET offset] 


where sig is one of the following choices, which correspond to the 
indicated processor inputs: 


Sig processor input pin 

IRQO (or 0) 

IRQ1 (or 1) TROT 

IRQ2 (or 2) IRO2 

IRQ3 (or 3) TRQ3 (ADSP-2100 only) 


For example, the command 

> interrupt irgd 400 500 

asserts the IRQO signal at intervals of 400 to 500 cycles. 
The following commands 

2» L iaregz 12.5 12.5 

or 

* 1 tro. 12.5 


cause IRQ2 to be generated once every 12.5 instruction cycles. The 
command 


> i2i2z.5 16 


causes IRQ2 to be generated once every 12.5 to 16 instruction cycles. 
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And the command 


> 1 2 l2Z.s 16 100 


causes IRQ2 to be generated once every 12.5 to 16 instruction cycles, 
with the first interrupt occurring at some time after a delay of 100 
cycles (after the I command is entered). 


When a simulation is running, the IREQ field in the interrupt control 
registers window indicates any pending interrupts (the IREQ bits are 
defined the same as IMASK bits). 


To use the IRQ1 or IRQO interrupt (on any family processor other than 
the ADSP-2100), serial port 1 must be in its alternate configuration. 
This configuration is determined by bit 10 of the processor’s system 
control register which is memory-mapped to address Ox3FFF in data 
memory. 


To enable the alternate configuration, you must set this bit to 0 in the 
control registers window (the bit is called SCNF1 in this window). For 
example, to set up IRQO in the ADSP-2101 simulator, enter the 
following commands in the command window: 


> Scntia 
> interrupt irqOd 400 500 


The I command also has options for setting serial port communication 
signals—these are described in Chapter 11. 


10.6.1. Interrupt Timing Window 


The interrupt timing window displays the timing parameters currently 
set for each external interrupt. You can enter values directly in the 
interrupt timing window by moving the cursor to a field and typing 
the value. This is equivalent to entering the Interrupt command in the 
command window, with the same parameters. 
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Figure 10.3 Interrupt Timing Window 


10.6.2 Simulating PWD & HALT 


The I command is also used to simulate the PWD (powerdown) input 
of the ADSP-21msp50 and the HALT input of the ADSP-2100: 


> 1 sig min [max] [OFFSET offset] 


S1g processor input pin 
HALT HALT (ADSP-2100 only) 
PWD PWD (ADSP-21msp50 only) 


This command, for example 
> 1 halt 200 
asserts the HALT input of an ADSP-2100 at 200-cycle intervals. (The 


state of this input is ignored unless the TRAP instruction is being 
executed.) 
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This example 


> 1 pwd 1000 1000 50 


asserts the PWD input of the ADSP-21msp50 at 1000-cycle intervals 
after a delay of 50 cycles. 


10.6.3 Simulating Flag In (Fi) 


The Interrupt command can also be used to generate a periodic Flag In 
(FD signal, with the following syntax: 


> 1 FI period [ONCE]|RESET] 


This command causes FI to be generated every period number of 
cycles. If the optional parameter ONCE is specified, FI occurs once 
only after a delay of period. If the optional parameter RESET is 
specified, the FI signal goes high after a delay of period and goes low 
when the state of FI is checked during program execution (for 
example, in the IF FLAG_IN CALL instruction). 


(Note: Like IRQ1 and [RQO, FI is only available when SPORT1 is in its 
alternate configuration; SCNF1 must be set to 0 in the simulator’s 
control registers window.) 

The following example 


> 1 £1 50 once 


causes the FI input to be asserted one time only, 50 cycles after the 
command is entered. 


10.6.4 Checking Input Signal Settings 


In addition to opening the interrupt timing window, you can check the 
current settings for any periodically generated input by entering the I 
command with only the signal name specified. For example, 


> 1 irq2 


displays the current settings for IRQ2 in the command output window. 


The command 
> i1iall 

or just 

> 1 


displays the current settings for all signals that can be periodically 
generated. The command 


> 1 active 


displays the current settings for only those signals that are currently 
being generated. 


10.6.5 Stopping Input Signal Generation 
To stop the generation of a periodic input, enter the I command with 
an interval of zero. For example, 


> 1 pwd 0 


stops the generation of PWD. 


10.7 RESETTING THE PROCESSOR 


There are two command window commands for resetting the 
simulated processor: Chip Reset and Reset No Boot. 


Chip Reset simulates a complete hardware reset of the processor. It is 
the same as pulling the RESET line low in hardware. All clocks, 
registers and stacks become reset or undefined. For processors with 
on-chip memory (i.e. all ADSP-21xx processors except the ADSP-2100), 
the state of this memory becomes undefined. (In some cases, values in 
on-chip memory may be the same after a reset, but this is not 
guaranteed.) If MMAP=0 in the architecture description file, boot page 
0 is booted into the processor’s on-chip program memory. Finally, the 
PC is set to the restart vector at address 0. In the simulator, execution 
does not begin, although it would in an actual device. 


Reset No Boot performs the reset functions of a chip reset but omits the 
boot loading sequence. Values in on-chip memory remain the same. 


10-11 


10-12 


To execute a chip reset, 


-Select Chip Reset from the Misc menu. 
Alternatively, you can enter 
> chipreset 
or 
=~ Cr 


in the simulator’s command window. To execute a Resetnoboot (RE) 
command, use the following syntax: 


> resetnoboot 


OF 


10.8 © PROGRAM EXECUTION 


The simulator executes programs in the run, single-step , or multi-step 
modes. When running, the simulator fetches and executes instructions 
exactly as a real ADSP-21xx processor would. 


In single-step mode the simulator updates the display after every 
cycle. 


10.8.1. Single-Step Execution 

Single-step execution steps the simulator through one instruction, 
updating the display of register and memory contents. This is useful 
when you wish to examine the processor’s state during cycle-by-cycle 
execution of your program. Execution always begins at the current 
program counter value. 


Multi-stepping steps through multiple instructions. In multi-step 
mode, the simulator will step execution for a specified amount of 
instructions, then stop. The display is not updated after each step; 
however, a progress indicator shows roughly how many instructions 
have been executed. 


To execute one instruction, 


-Select Step from the Execution menu, or press F10. 
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Alternatively, you can enter 


> step 


Or 


=~ § 


in the simulator’s command window. To execute several instructions 


at once, 


-Select Step ‘n’ Times from the Execution menu, or press Shift-F10. 


-Enter a value for ‘n’, the number of instructions to execute. 
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Or, enter 


> step n 
or 
>sn 


in the simulator’s command window, with n equal to the number of 
instructions to execute. For example, the command 


> 6 10 
executes the next ten instructions, while 
>. 8 


executes only the next instruction. You can always press any key to 
halt execution. 


During single-step or full-speed execution, the simulator shows the 
current value of the PC by highlighting that address in the program 
memory window. If you have enabled echoing (in the defaults 
window, described below), the command output window also shows 
the next instruction to be executed. 


Note: Breakpoints are ignored when single-stepping but are enabled 
while multi-stepping. 


10.8.2 Running & Halting 


To execute your program at full speed for an unlimited number of 
instructions, starting at the current value of the PC, 


-Select Run from the Execution menu, or press F4. 
Or, you can enter 
> go 


or 


in the simulator’s command window. Once the simulator is running it 
will halt only for the following events: 


You press any key 

A simulation error occurs 

The program counter reaches a breakpoint address 
A break expression becomes true 


You can also give the Go (G) command an address—either a constant, 
a program label, or an expression—to stop at: 


> go addr 
or 
> g addr 


Execution continues until the PC reaches that address. For example, 
> go pm(fir_halt) 


executes instructions up to the instruction labelled fir_halt. Note that 
the address to run to must be given with the usual PM() notation. 


If you use the Run (or Go) command in a keystroke file, you should 
first set the value of RUN Timeout in the defaults window (see 
“Execution Defaults” below). Execution started by a Run or Go 
command will not be interrupted by any keystroke entry in the file 
until the RUN Timeout time period has expired. The value entered for 
RUN Timeout is interpreted as real time (in seconds), not as execution 
cycles. 


10.8.3 Entering & Executing A Single Instruction 


You can enter and execute any instruction directly without loading it 
into program memory. This is accomplished with the Execute (EXE) 
command, given in the command window. The general form of this 
command is 

> execute instr 


Or 


Ss exe instr 
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where instr is any valid ADSP-21xx instruction, with or without a 
terminating semicolon. 


This operation is not the same as patching a program already loaded in 
memory with the Assemble (A) command (on-line assembler). The 
instruction given with the Execute command is not placed in program 
memory—it is executed only when the command is entered in the 
command window. 


For example, to move the contents of register AYO to register AXO, you 
would enter 


> execute ax0=ay0; 


10.8.4 Execution Defaults (Defaults Window) 


There are a number of miscellaneous defaults for program execution in 
the simulator. You can change these settings in the defaults window. 
To open the window, select Defaults from the Misc menu. Figure 10.5 
shows an example of this window. 
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¢ Beep Enable turns on the bell or beep of your computer; the simulator 
will beep for each error or breakpoint reached. 


e Echo Enable makes the simulator echo every valid instruction in the 
command output window, as it is fetched while single-stepping 
through a program. 


e Screen Update Rate sets the number of instruction cycles simulated 
before the screen is updated during continuous program execution (see 
the discussion of the Run/Go command later in this chapter). Enter any 
number in this field; the larger the number, the faster the simulation 
will run. 


e RUN Timeout sets the maximum time allowed for a Run (or Go) 
command executed from a keystroke file, to prevent runaway program 
execution if a breakpoint is not reached. The simulator will wait this 
number of seconds before executing the next command in the keystroke 
file (if a break is not reached). The value entered for RUN Timeout is 
interpreted as real time (in seconds), not as execution cycles; you must 
estimate approximately how long your program should normally take 
to run. 


10.9 | DEBUGGING WITH EXECUTION BREAKS 


Breaks halt execution to allow debugging in the simulator. Breaks 
include breakpoints, multi-breakpoints, break address ranges, break 
expressions, and break change expressions. 


10.9.1. Breakpoints 

A breakpoint is a location in program memory at which the simulator 
stops executing code. It stops after executing the instruction just before 
the breakpoint instruction, allowing you to view the contents of 
processor registers and memory. 


There are several ways to set and clear breakpoints. With the program 
memory window open, find the location where you want to set a 
breakpoint; select the instruction at that location by clicking on it with 
your mouse (or use the up/down arrow keys). Now, you can either 


-Select Set/Clear Breakpoint from the Execution menu, or press F9. 


or simply double-click on the instruction. This will set the breakpoint, 
or, if one is already set at that location, it will clear it. Repeating this 
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action toggles the breakpoint on and off. The Clear All Breakpoints 
command in the Execution menu can also be used to deactivate all 
breakpoints (as well as all multi-breakpoints). 


Alternatively, you can set a breakpoint from the simulator’s command 
window by giving the Break (B) command: 


> break addr 
or 
> b addr 


where addr is the address at which to set the breakpoint, given in the 
PM() format. The following command, for example 


> break pm(0x001A) 


sets a breakpoint at address PM(0x001A). A running simulation halts 
when the instruction at this address is fetched, but before it is 
executed. 


The breakpoint address can also be specified as a program label, as in 
the following example: 


> b om(start) 


The simulator shows where breakpoints are set by highlighting each 
one in the program memory window. (What is actually highlighted is 
the Internal/External RAM/ROM indicator to the left of the address.) 


10.9.2 Multi-Breakpoints 


Multi-breakpoints are breakpoints which halt execution only after 
being hit a certain number of times. You select the occurrence on 
which to break, for example on the n™ iteration of an instruction 
located within a loop. Multi-breakpoints do not work with single- 
stepping; you must use full-speed execution (Run/Go). 


To set (or clear) a multi-breakpoint in the program memory window, 
first select the location with your mouse or arrow keys, and 


-Select Set/Clear Multi-Breakpoint from the Execution menu, or 
press Shift-F9. 


-Enter a number for the occurrence on which to break (i.e. the 
number of times the location is hit before breaking). 


This will set the multi-breakpoint, or, if one is already set at that 
instruction, it will clear it. Repeating this action toggles the multi- 
breakpoint on and off. The Clear All Breakpoints command in the 
Execution menu can also be used to clear all multi-breakpoints. 
Alternatively, you can set a multi-breakpoint from the simulator’s 
command window with the Break (B) command. Use the following 
syntax to halt execution after the specified address is reached n times: 
> break addr, n 

or 

> b addr, n 

The following command, for example, 


> b pm(0smi234), 5 


will halt execution after the instruction at program memory address 
0x1234 has been executed four times. In the following example, 


> b pm(add_loop), 3 


a multi-breakpoint is set for the third time the add_loop label is reached. 
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10.9.3 Displaying The Breakpoints Currently Set 


To view a list of all breakpoints and multi-breakpoints currently set, 
-Select Display Breakpoints from the Execution menu. 


The breakpoint display window opens, showing a list of active 
breakpoint and multi-breakpoint addresses. For multi-breakpoints, the 
occurrence is also shown. Breakpoints are shown with an occurrence of 
1. Figure 10.6 shows an example of the breakpoints display window. 
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Figure 10.6 Breakpoints Display Window 


Another way to obtain a list of active breakpoints (and break address 
ranges) is to give the Break (B) command with a question mark: 


> break ? 


Or 
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Or, simply give the Break command with no argument(s) at all: 
> break 

or 

> b 


The list of breakpoints, multi-breakpoints, and break address ranges is 
displayed in the simulator’s command output window, as shown in 
Figure 10.7; they are numbered from [20] to [39], in the order in which 
they were defined. You can have a total of 20 breakpoints and multi- 
breakpoints active at any one time. Break address ranges are 
numbered from [40] to [59]. 
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Figure 10.7 Breakpoints Listed In The Command Output Window 
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10.9.4 Break Address Ranges 


Break ranges act the same as breakpoints except that they break on a 
range of addresses, not just on a single location. An instruction fetch 
from any address within the range causes the execution to break. A 
break range is set with the following command: 


> breakrange addr, addr 

or 

> br addr, addr 

The following command, for example 

> br pm(0x001A) ,pm(0x0024) 

sets a break range over the addresses 0x001A-0x0024. 


10.9.5 Break Expressions & Break Change Expressions 


The simulator can also break execution on the state of an expression. It 

can break either whenever an expression is true (i.e. not logical zero) or 
whenever the value of an expression changes. Register names, memory 
contents, and numerical constants can be used to create the expression. 


The Breakexpression (BE) command is given in the simulator’s 
command window with the following syntax: 


> breakexpression expr 
Or 
> be expr 


For example, you may wish to break execution whenever the 
expression 


AX0 > 3 


is true. As long as the AXO register contains a value less than or equal 
to three, the expression is false and program execution continues. 


When AX0 is loaded with a larger value, however, the expression 
becomes true and the simulator halts. Enter this break expression as 
follows: 

> breakexpression ax0 > 3 

In the following example, the command 

> be 10 == 0x1234 

causes a break when the value of the I0 register becomes 0x1234, and 


> be 10 != 0x1234 


causes a break when the value of I0 is not 0x1234. The full list of logical 
operators supported by the simulator is given in Chapter 6. 


A break expression can also check whether a value is undefined, such 
as uninitialized registers or memory locations. UND is used to 
represent the undefined value. For example, 


> be statusO != und 


causes a break when the top of the status stack is written for the first 
time. 


The Breakchange (BC) command sets up a break change expression, 
which halts execution upon any change in the value of an expression: 


> breakchange expr 

or 

> bec expr 

An expression can be as simple as a single register, as in the command 
> bce ax0 


which halts upon every change in value of the AX0O register. 
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The break expressions window shows the current list of break 
expressions and break change expressions, along with their current 
value. To open this window, 

-Select Break Expressions from the Execution menu. 


Numbering of break expressions runs from [0] to [19]. 


10.9.6 Clearing Any Break From The Command Window 

There is a single command for clearing any type of execution break— 
breakpoints, multi-breakpoints, break address ranges, break 
expressions, or break change expressions—from the command 
window. The Breakdelete (BD) command is entered in this way, 

> breakdelete break# 

or 


> bd break# 


where break# is the number of the break to be cleared, as displayed in 
the command output window by the break ? command. Numbering of 
breaks is as follows: 

[0] - [19] break expressions 

[20]- [39] breakpoints, multi-breakpoints 

[40]-[59] break address ranges 

To delete all breaks in one fell swoop, enter 


> bd all 


in the command window. 


10.10 DEBUGGING WITH WATCHPOINTS 


Watchpoints and watch expressions are the same as breakpoints and 
break expressions except that they only display a message and do not 
halt execution. Whenever a watchpoint address is read or written, a 
message and the location’s contents are displayed in the command 
output window. Watch address ranges can also be set. 


Watchpoints may only be set on locations in data memory or program 
memory that contain data, not instructions. 


10.10.1 Watchpoints & Watch Address Ranges 


The Watchpoint (W) command, given in the command window, sets a 
watchpoint or watch address range. To set a watchpoint, enter the 
command with a single address (located in data memory or program 
memory): 

> watchpoint addr 

or 


> w addr 


For example, the command to set a watchpoint on data memory 
location 0x003F is 


> w dm(0x3f) 


To define a watch address range, enter the Watchpoint command with 
an address range (located in data memory or program memory): 


> watchpoint addr, addr 

or 

> w addr, addr 

The following command, for example 

> w pm(0Ox001A) ,pm(0x0024) 

sets a watch address range over the program memory addresses 


0x001A-0x0024, which must contain data. A maximum of 25 
watchpoints can be active simultaneously. 
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To list all watchpoints, watch address ranges, and watch expressions 
along with their assigned numbers in the simulator’s command output 
window, give the W command with no arguments: 


> W 


You must know a watchpoint’s or watch expression’s number to delete 
it. 


To clear any watchpoint, watch address range, or watch expression, 
give the Watchdelete (WD) command: 


> watchdelete watch# 
or 
> wd watch# 


where watch# is the number of the watchpoint, watch address range, or 
watch expression to be cleared. 


10.10.2 Watch Expressions 


The Watchexpression (WE) command, given in the command window, 
defines a watch expression. A watch expression acts like a break 
change expression without halting execution. The command syntax is 
> watchexpression expr 

or 


> we expr 


where expr is any valid expression. For example, if you want to know 
when the ALU carry bit (AC) changes, enter the command 


> we ac 
The command 

-~ WO ac + av 

causes the simulator to display a message whenever the sum of the AC 


and AV bits changes. A maximum of 25 watch expressions can be 
active simultaneously. 


10.11 EXECUTION HISTORY (TRACE WINDOW) 


The trace window captures a history of processor activity during 
program execution. You must enable tracing before running some 
portion of code. In a typical debugging session you might set a 
breakpoint, run to that instruction, and look at the results of the last 
few cycles executed. 


To open the trace window, 
-Select Trace from the Misc menu. 


Now type Ctrl-R. You are prompted for the number of lines of code to 
record (i.e., to trace). One cycle of execution history is recorded per 
line. Enter any number—the maximum is limited by memory—and 
press Return. The default value is 10. 


With trace enabled, execute code with the Step or Run/Go commands. 
As execution proceeds the trace window shows the value of the PC, 
the instruction executed, and any data bus activity. Once the specified 
number of cycles/lines have been filled up, the oldest lines are deleted 
as new lines are recorded. 


Figure 10.8, which can be found on the following page, shows the trace 
window. To the right of each instruction is shown any data memory 
read or write performed and any program memory data read or write 
performed. 


The trace history can be too long for the trace window to display at 
once, depending on the size of the window and the length of the trace. 
You can scroll through the trace using the arrow keys and the Page Up 
and Page Down keys. To show the start of the trace, press the HOME 
key; to show the end of the trace, press the END key. 


You can change the trace length at any time by typing Ctrl-R in the 
trace window and entering a new number. 
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Figure 10.8 Trace Window 


10.12 EXECUTION PROFILING (PROFILE WINDOW) 


An execution profile shows the time spent executing instructions in 
different portions of a program. It allows you to analyze the execution 
patterns of your program. To create a profile, you open the profile 
window, select parameters, enable profiling, and then run your 
program. You can examine the results in the profile window. 


The simulator counts the cycles spent executing instructions in each 
address range you identify. In the example profile window shown in 
Figure 10.9, the user-defined ranges (1, 2, and 3) are 0x001D-0x0025, 
0x0026-0x0028, and 0x0029-0x002A. The simulator also automatically 
counts cycles for all other ranges, during IDLE instructions, and 
during extra cycles of multicycle instructions (e.g., memory accesses 
with wait states). These counts are shown in the profile window next 
to other, idle and extra cycle. 
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Execution time for each range is expressed as a percentage of a time 
period. The profile covers three time periods: short-term, long-term 
and cumulative. These are depicted in Figure 10.10 (on page 10-30). 
The short-term and long-term time periods are relative to current 
cycle; that is, a time period of 10 cycles is always the most recent 10 
cycles. You choose the number of instruction (execution) cycles in the 
short-term and long-term time periods. The cumulative time period is 
always the total number of execution cycles since you last reset the 
profile. 


The short term count specifies the number of cycles in the short term 
period; in Figure 10.9, this parameter is set to 2. The long term period 
is always a multiple of the short term period. The long term count 
specifies a number of short term periods. In Figure 10.9, it is set to 2, 
meaning 2 X 2 = 4 cycles. 
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Figure 10.9 Profile Window 
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Figure 10.10 Short Term, Long Term & Cumulative Profiling Time Periods 


The rightmost column of the profile window, labeled Cum, shows the 
percent of the cumulative time spent in each range since you last reset 
the accumulated data. The columns labeled STA (short-term average) 
and LTA (long-term average) list the percent of the short-term and 
long-term time periods, respectively, for each range. The area under 
the labels 0%, 25%, 50%, 75% and 100% displays a simple histogram of 
the information in the Cum, STA and LTA columns. 


10.12.1 Setting Up Profiling 


To open the profile window and choose parameters, 
-Select Profile from the Misc menu. 


After the window opens, you can enter your choices for the short term 
count and long term count parameters. Use your mouse or keyboard 
arrow keys to move the cursor from Short term count to Long term 
count and then to Enable. Type an “E” to enable profiling (or a “D” to 
disable profiling). 


There are two ways to define your profile address ranges, by enterin 
them directly in the profile window or by using the Profileadd (PA) 


CUMULATIVE 


command in the command window. To enter the address ranges in the 
profile window, move the cursor to line 1 and type in the first range: 


1) pm(addr) ,pm(addr) 
Press Return and enter the next address range on line 2. Continue in 
this manner until all of your profile ranges are entered. You can define 
a total of 19 ranges; the simulator always includes the other, idle, and 
extra cycle counts. 


To define a new profile range (or replace an existing range) from the 
command window, give the Profileadd (PA) command: 


> profileadd range# addr, addr 

or 

> pa range# addr,addr 

The range# can be any number from 1 to 19. A single address can be 
specified instead of a range, to profile the execution of a single 
instruction. 

The following command, for example 

> profileadd 1 pm(0x001D),pm(0x0025) 

defines the first profile range as program memory addresses 
0x001D-0x0025. The profile window of Figure 10.9 shows the profiling 


setup created by this example command plus the following two: 


> pa 2 pm(0x0026) ,pm(0x0028) 
> pa 3 pm(0x0029) ,pm(0x002A) 


To delete an existing profile range, give the Profiledelete (PD) 
command in the command window: 


> profiledelete range# 
or 


> pd range# 


10-31 


10 - 32 


You can also remove a range by deleting the addresses directly in the 
profile window. The PC command, described below, deletes all ranges 
as well as the accumulated profile data. 


10.12.2 Clearing The Profile Data 


The Profilereset (PR) command, given in the command window, clears 
all profile data but leaves the current definition of address ranges 
undisturbed. It has the form 

> profilereset 

or 


> OF 


10.12.3 Clearing The Profile Setup 


The Profileclear (PC) command deletes all ranges as well as the profile 
data. Its form is 


> profileclear 
or 


> pC 


/O Operations 


11.1 OVERVIEW 


This chapter tells you how to simulate data I/O operations. Examples 
of many of these operations are shown in the tutorial in Chapter 7, 
Getting Started. 


All ADSP-21xx family processors use memory-mapped parallel I/O 
ports to read and write data from and to peripheral devices. All of 
these processors, except the ADSP-2100, also have one or two serial 
ports that allow them to read and write serial data. The ADSP-2111 
and ADSP-21msp50 each include a host interface port (HIP) for 
parallel data transfers to and from a host processor. The ADSP- 
21msp50 also includes an analog interface with A/D and D/A 
converters for sending and receiving analog signals. The simulator 
provides features for simulating each of these external interfaces. 


11.2 MEMORY-MAPPED I/O PORTS 


Parallel I/O ports in data or program memory that are defined in the 
architecture description file must be explicitly opened to be simulated. 
When you open a port, you associate it with an input data file and/or 
an output data file. An input file serves as the source for simulated 
input and an output file serves as the destination for simulated output. 
You can analyze the data files after simulation to assess the processing 
of your algorithm. 
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11.2.1. Opening Memory-Mapped I/O Ports 


There are two ways to open a memory-mapped I/O port; you can 
open the port by selecting menu items and completing the pop-up 
window, or by typing a command in the command window. 

To open a port through the menu: 


1. Select Open, located under Port Display, in the Memory menu. This 
displays the pop-up window shown in Figure 11.1. 


2. In the pop-up window, complete the following fields: 


Memory Port defined as PM or DM in the architecture file 
Address Port address defined in the architecture file 

File Format = Hexadecimal, fixed-point, or floating-point data 
Autowrap (input files only) Specifies whether or not the file 


pointer is wrapped back to the top of the file when 
an end-of-file (EOF) condition is detected; also 
referred to as “circular” files 
Input Input file data is read from (include file extension) 
Output Output file data is written to (include file extension) 


You can use the mouse or T, J, 3, &, keys to select the fields and 
options. Type in the filenames with the file extensions. Then press 
Return. 


Note: The input file must already exist, but the simulator creates the 
output file when it opens the port. 


To open a port from the command window enter the Openport (OP) 


command: 
> openport address [>’outfile’] [<‘infile’] 
or 
> op address [>’outfile’] [<‘infile’ ] 


where address is a standard address specifier or symbolic port name, outfile 
is the name the output file that collects the simulated data and infile is the 
name of the input file that holds the simulated inputs. Files may be 
specified in either order, always in single quotes; you must give the full 
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filenames including extensions, if any. Giving both an input and an output 
file opens a bidirectional port. Giving just an input or an output file opens 
an input-only or output-only port. 


The following example: 


> OpEenpOoOrt dac_ out =*filtout.dat’ 


opens the file £iltout.datfor output. Any data written to DM 
location labeled dac_out during program execution gets stored in this 
file. Note that either dac_out or the equivalent address can be 
specified in the Openport command. 


Note: When you open an I/O port from the command window, the 
simulator sets the I/O port to read and write the input and output files 
in the current data format as the command window (hexadecimal or 
decimal). If you want specify data files as fixed- or floating-point, use 
the pop-up window described above. 
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Port Open Menu 
Memory Address File Format Autowrap Input Filename Output Filename | 


in data.dat  out_data.dat 


Accept Port Configuration? 
YES NO 


ommand Window (Hex) 
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Figure 11.1 Pop-Up Window For Opening Ports 
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11.2.2 Circular I/O Data Files 


You can define I/O port input data files as “circular.” When the 
simulator reads the last data value, it automatically points back to the 
beginning of the file ( the end-of-file message is not displayed). 
Activate the circular option by entering the Openport command in the 
following way: 


> openport port_name <’filename’, circ 
or 
> op port_name <‘’filename’, circ 


Using the keyword circ defines the data file as circular. 


11.2.3 Checking Port Status 


You can check the status of the ports from the port display window 
(shown in Figure 11.2). This window lists the opened ports and 
displays the attributes associated with each port. This window is only 
a status window, you cannot open, close, or change ports from this 
window. To display the port display window, select Port Display from 
the Memory menu. 
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Port Display 
Memory Address File Format Autouwrap Input Filename Output Filename 


xin.dat out _data.dat 
yin.dat dac_out.dat 
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Figure 11.2 Port Display Window 
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11.2.4 Closing Memory-Mapped I/O Ports 


There are also two ways to close an I/O port; you can close the port 
from the pop-up window or from the command window. 


To close a port from the pop-up window: 


1. Select Close, located under Port Display, in the Memory menu. This 
displays the pop-up window shown in Figure 11.3. 


2. Select a port with the T and J keys or with the mouse. Then press 
Return. The selected port is closed, the file buffers are flushed, and 
the file itself is closed. 

To close a port from the command window: 


Enter the Openport command and port address without file 
arguments, for example, 


> openport dac_out 


closes the port at address dac_out. 
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Port Close Menu 
Memory Address File Format Autowrap Input Filename Output Filename | 


a) a) 4) 4) out_data.dat 
0461 yin.dat dac_out.dat 


Select port to close or <ESC> to abort 
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Figure 11.3 Pop-up Window For Closing Ports 
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11.3 SERIAL PORTS 


Most of the processors of the ADSP-21xx family have two serial ports, 
or SPORTs. To simulate serial port data transfers, you must open a 
serial port and assign an input file and/or an output file to it. You can 
also examine and change the values of the memory-mapped control 
and status registers associated with SPORT operation. This section 
describes commands and windows used in SPORT simulation. 


11.3.1. Opening A SPORT 


SPORTs must be explicitly opened to be simulated. When you open a 
SPORT, you associate it with one or two data files. An input data file 
serves as the source for simulated serial input. An output data file 
serves as the destination for simulated serial output. You can analyze 
these data files after simulation to assess the processing of your 
algorithm. 


There are two ways to open a SPORT; you can open the SPORT by 
selecting menu items and completing the SPORT files window, or by 
typing syntax in the command window. 


To open a SPORT through the SPORT files window: 


1. Select SPORT Files, from the File menu. This displays the SPORT 
files window shown in Figure 11.4. 


2. In this window, complete the following fields for each SPORT: 


Input Input file data is read from (include file extension) 
Output Output file data is written to (include file extension) 
Circular (input files only) Specifies whether or not the file 


pointer is wrapped back to the top of the file when 
an end-of-file (EOF) condition is detected; enter “Y” 
or “N”. 
You can use the mouse or 7, J, 3, €, keys to select the fields and 
options. Type in the filenames with the file extensions. Then press 
Return. 


Note: The input file must already exist, but the simulator creates the 


output file when it opens the SPORT. However, you cannot read the 
contents of the output file until the SPORT is closed. 
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PORT Files 
Sport @ Sport 1 
input: adc_in.dat voice_in.dat 
output: out_data.dat buff _ out .dat 
circular: y N 
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Figure 11.4 SPORT Files Window 
To open a SPORT from the command window: 
Enter the Opensport (OS) command with the form 
> opensport sport# >’outfile’ <‘infile’ 


or 
> os sport# >'’outfile’ <‘infile’ 


where sport# (0 or 1) designates either SPORTO or SPORT1, outfile is 
the name of a file that collects output data and infile is the name of a 
file that supplies simulated input data. Files may be specified in 
either order, always in single quotes; you must give the full 
filenames including extensions, if any. Giving both an input and an 
output file opens a bidirectional SPORT. Giving just an input or an 
output file opens an input-only or output-only SPORT. 
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The following example, 


> opensport 1 >’output.dat’ 


opens SPORT 1 and the output file output .dat. Any data written to 
SPORT1 during program execution gets stored in this file. 


The data files for SPORT simulation must contain only ASCII 

1s and Os, to simulate the serial bit stream, and carriage returns (which 
are ignored). This .DAT format for SPORT data files is completely 
described in Appendix F, File Formats. 


11.3.2 Circular Serial Port Data Files 


You can define serial port input files as “circular.” When the simulator 
reads the last data value, it automatically points back to the beginning 
of the file (the end-of-file message is not displayed). Activate the 
circular option by entering the Opensport command in the following 
way: 


> opensport sport# <’filename’, circ 


Using the keyword circ defines the data file as circular. 


11.3.3 Closing A SPORT 


To close a SPORT, enter the Opensport command and SPORT 
identifier without file arguments. For example 


> os 0 
closes SPORTO. 
11.3.4 SPORT Registers Windows 


The SPORT data and control registers are displayed in two windows, 
one for each SPORT. Figure 11.5 shows the SPORT0 register window. 


You can alter the contents of a register directly in two ways. First, 
when the SPORT registers window is active you can select a register’s 
value or a field’s value by moving the cursor to that field and type the 
new value. When you press Return, the new value replaces the old 
value. 
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Sport 6 Registers (Hexadecimal) 
SLEN6: 6 DTYPE6: 6 ISCLK6: 6 
IRFS6: @ RFSR@: 6 RFSWH: 6 INVRFSO: 6 # 
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> UUUU MCTE1: uuu MCFD: 6 
ULULULLL TX68: uunuw 
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Figure 11.5 SPORTO Registers Window 


The second method for changing a register is from the command 
window. The SPORT registers window does not have to be open. In 
the command window, enter the command 


> register = expression 


where register is the name of the SPORT register or bit field and 
expression is the value to be loaded into the register. For example, 


> Cx = UxXOUEE 


writes the value OxO0OFEF to TX0. 
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The bit fields displayed in the SPORT register windows are defined 
below. When “(SPORTO)” precedes one of the definitions, this 
indicates that the item appears only in the SPORTO window. 


SLEN 
DTYPE 


ISCLK 


IRFS, ITFS 


RFSR, TFSR 


RFSW, TFSW 


INVRES, INVTFS 


SCLKDIV 
RFSDIV 


RBUF, TBUF 


RIREG, RMREG 
TIREG, TMREG 


MCREO0, MCRE1 


Serial length of the data word (4 bits), SPORTs 
handle word lengths from 3 to 16 bits 

Data type (2 bits), available formats are A-law/ 
u-law companding, and two non-companding 
formats 

Internal serial clock enable bit, determines if the 
processor generates the SCLK signal or 
receives an external signal on SCLK 

Internal receive (IRFS), transmit (ITFS) frame 
sync bits, determine if processor generates 
frame sync signal or receives an external signal 
on RFS or TFS 

Receive (RFSR), transmit (TFSR) frame sync 
required bits, determines if a sync bit is 
necessary only once to start communications, 
or if a sync bit is necessary with each data 
word 

Receive (RFSW) , transmit (TFSW) frame synch 
width, enables normal or alternate framing 
modes 

Inverted receive (INVRFS), transmit (INVTFS) 
frame sync enable bits, determines if the active 
frame sync bit is high or low when 
multichanne mode is enabled 

Serial clock divisor (16 bits), sets internal serial 
clock frequency 

Receive frame sync divisor (16 bits), sets receive 
frame sync frequency 

Receive (RBUF) , transmit (TBUF) autobuffering 
enable bits, lets the processor receive or 
transmit an entire block of serial data before 
an interrupt is generated, when disabled, an 
interrupt is generated for each data word 

Receive autobuffering I (RIREG, 3 bits) and M 
(RMREG, 2 bits) registers 

Transmit autobuffering I (TIREG, 3 bits) and M 
(TMREG, 2 bits) registers 

(SPORTO) Multichannel receive word enable 
registers (16 bits each), MCREO lets words 
0-15 be received and MCRE1 lets words 16-31 
be received 


MCTEO, MCTE1 (SPORTO) Multichannel transmit word enable 
registers (16 bits each), MCTEO lets words 0-15 
be transmitted and MCTE1 lets words 16-31 be 


transmitted 

MCE (SPORTO) Multichannel enable bit, enables 
and disables multichannel mode 

MCFD (SPORTO) Multichannel frame delay (4 bits), 


determines the number of serial clock 
cycles between the frame sync bit and the 


first data bit 
RX Receive data register (16 bits) 
TX Transmit data register (16 bits) 


e SLEN, DTYPE, ISCLK, IRFS, TRFS, RFSR, TFSR, RFSW, TFSW, INVRES, 
INVTEFS, MCE, and MCFD are Iccated in the SPORTO Control Register at 
DM(0x3FF6). FO replaces MCE in the SPORT1 Control Register at 
DM(0x3FF2). 


e RBUF, TBUF, RIREG, RMREG, TIREG, and TMREG are located in the 
SPORTO0 Autobuffer Control Register at DM(Ox3FF3) and the SPORT1 
Autobuffer Control Register at DM(Ox3FEF). 


For a detailed description of serial ports, see the ADSP-2100 Family 
User’s Manual. 


11.3.5 Simulating External SPORT Signals 

The simulator provides several ways to simulate input from an 
external source. You can configure a SPORT to generate periodic 
control signals (clock and frame sync) at an interval you specify, you 
can tie the frame syncs together, or you can configure a SPORT to 
loopback the frame sync and data outputs as input signals. These 
methods are explained in the following sections. 
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11.3.5.1 Generating Periodic SPORT Signals 
The simulator can generate the following SPORT signals periodically: 


SCLKO 
RFSO 
TFSO 


SCLK1 
RFS1 
TFS1 


To set up external SPORT signal generation, you must first set the 
values of bits in the appropriate SPORT control register for external 
generation of the particular SPORT signal. These bits are shown as 
fields in the SPORT register window. You can then enter the I 
command to program a periodic SPORT signal with the form: 


> 1 signal min [max] [offset cycles] 


where signal is one of the six signal names listed above; min is the 
minimum interval in instruction cycles; max is the maximum interval 
in instruction cycles (default is equal to min); and offset is the number 
of instruction cycles before first the interrupt is generated (default is 0) 


For example, to generate an RFSO pulse every 900 processor cycles, 
with the initial pulse delayed by 40 cycles, you would enter the 
following command: 


> 1 rfsO 900 offset 40 


11.3.5.2 Linking Frame Syncs Together 

Another way to provide external frame sync signals to a SPORT is to 
tie a SPORT’s internally generated frame sync to either its own input 
or the input of the other SPORT (in processors that have two SPORTs). 
To tie the frame syncs together, use the Connect command in the 
following form 


> connect ris# tis 


where rfs# isa0Qor1 to indicate RFSO or RFS1; tfs# isaQor1 to 
indicate TFSO or TFS1. For example, 


> connect 0 1 

connects RFSO to TFS1. 

The bits in the SPORT control registers, which appear in fields in the 
SPORT register window, must be configured for internal generation of 


one frame sync and external generation of the other. 


To view all RFS-to-TFS links that are currently in effect, enter the 
Connect command with no arguments: 


> connect 


To disconnect a link created by the Connect command, enter the 
command with the OPEN argument: 


> connect rfs# tfs# open 
To disconnect all links currently in effect, enter 


> connect all open 


11.3.5.3 Loopback SPORT Output To Input 

The Loopback (LB) command connects the control and data lines of a 
serial port together: its TFS output is connected its RFS input and its 
DT output is connected to its DR input. The SPORT can then transmit 
data to itself to simulate external input. The syntax of the Loopback 
command is: 


> loopback sport# 
or 


> lb sport# 
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where sport# is 0 or 1 to indicate SPORTO or SPORT1. The SPORT must 
be programmed to generate TFS internally and to receive RFS 
externally. For example, to loopback SPORT0: 


> loopback 0 


Although the TFS is generated internally and connected to RFS, the 
simulator still requires you to generate an external RFS as shown in 
section 11.3.5.1. 


To view a list of SPORTs that are in loopback mode, enter the 
Loopback command with no argument: 


> loopback 


To disconnect a loopback, enter the Loopback command with the 
OPEN argument: 


> loopback sport# open 
To disconnect all loopbacks currently in effect, enter 


> loopback all open 


11.4 HOST INTERFACE PORT (ADSP-2111 & ADSP-21MSP50) 

To simulate the host interface port (HIP) of the ADSP-2111 and ADSP- 
21msp5x, you can examine and alter the contents of its registers 
directly. You simulate host writes by writing toa memory mapped 
data register (HDR). You can also associate data files with the HIP to 
simulate host data transfers. 


11.4.1. Reading & Writing HDRs 


By convention, the simulator calls a data transfer from the host a write 
and a transfer to the host a read; in other words, write and read are 
from the host’s perspective. 


The top portion of the HIP registers window (shown in Figure 11.6) is 
divided into three fields—the Edit field, the 2111 field (representing 
either the ADSP-2111 or ADSP-21msp5x) and the Host field. The six 
memory mapped HIP data registers (HDRs) appear in each of the three 
fields. 


There are two ways to write to the HIP. The first way is to highlight 
the field in the HIP registers window and type in the new value, then 
press Return. The new value replaces the old. You can enter either a 
value or the word READ in an HDR: 


e Typing a value in the Host field simulates a write to the ADSP-21xx; the 
HDR is changed and a write interrupt is generated. 


e Typing a value in the 2111 field has the same effect as an immediate 
data move to an HDR from the ADSP-21xx. 


e Typing READ in the Host field simulates a Host read of the HDR; the 
ADSP-21xx generates a read interrupt. 


¢ Typing READ in the 2111 field simulates the effect of the ADSP-21xx 
reading the HDR (the data is not transferred anywhere, but the 
HDR’s status changes). 


In the Edit field you can enter data values in HDRs without causing 
any interrupts or HSR changes. This field allows you to change an 
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HDR6#_EDIT: ; HDR#_HOST: 
HDR1i_EDIT: : HDR1_HOST: 
HDR2_EDIT: ; HDR2_HOST: 
HDR3_EDIT: : HDR3_HOST: 
HDR4_EDIT: : HDR4_HOST: 
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Figure 11.6 HIP Registers Window 
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HDR value without changing the HIP status. You can also type READ 
in the Edit field, but this has no effect unless the HDR is associated 
with an input file (as described later). 


The second way to write to the HIP is by entering the Fill (F) command 
in the command window. Each field has a unique name that can be 
used in the Fill command: 


> fill fieldname value 


where value is a hexadecimal value or READ, and fieldname correspond 
to the one of the fields in the HIP registers window: 


HDRO_EDIT HDRO HDRO_HOST 
HDR1_EDIT HDR1 HDR1_HOST 
HDR2_EDIT HDR2 HDR2_HOST 
HDR3_EDIT HDR3 HDR3_HOST 
HDR4_EDIT HDR4 HDR4_HOST 
HDR5_EDIT HDR5 HDRS_ HOST 


For example, to change the value in HDRO to 0 without causing any 
interrupts or status change, enter 


> fill hdrO_edit 0 
To simulate the host writing OxFF to HDR1, enter 
> fill hdri_host OxFF 


To simulate the processor reading the value of HDR1 (previously 
written by the host) enter 


> fill hdrl read 


11.4.2 Inspecting & Writing HMASK 


Directly below the 2111 field column in the HIP registers window is a 
representation of the HMASK register. You can change the HMASK 
value in one of two ways (besides the execution of a program 
instruction that changes HMASK): 


e Move the cursor to the HMASK field and type a new value. 


e Enter the Fill command in the command window. 
> fill hmask value 
where value is a hexadecimal value. 


11.4.3 Inspecting & Writing HIP Status 

The middle portion of the HIP registers window (under STATUS) 
monitors the HIP status registers (HSRs). Changes to the Host and 

2111 fields in the top portion of the window are reflected by a change 
in the HSR values. The upper two bits of HSR7 are shown separately in 
the HIP_OVWRITE (bit 7) field and the HIP RESET (bit 6) field, as 
well as in the value of HSR7 itself. These bits control the HIP overwrite 
mode and software reset. 


The bottom portion of the HIP registers window is a table that shows 
the transfer status of each of the HDRs. You cannot directly alter any 
values in this table. The columns labeled 0 1 23 45 refer to the HDRs. 
An “e” indicates that the HDR is empty (has been read since the last 
update to this HDR). An “f” indicates that the HDR is full (has not 
been read since the last update to this HDR). The values in the row 
labeled 2111 indicate the status of transfers from the ADSP-21xx, and 
the values in the HOST row indicate the status of transfers from the 
host. 


11.4.4 Simulating Continuous HIP Data Transfers 

The simulator simulates asynchronous host transfers. There are two 
steps to programming this function. The first is to associate a data file 
with the HIP to simulate a data stream to or from a host (in the same 
way as with I/O ports and SPORTs). The second is to enable the 
generation of periodic transfers to or from a file, to simulate host reads 
and writes. 


If you open a file for an HDR but do not program periodic transfers, 
you can still transfer data to or from the file manually. When an input 
file is associated with an HDR, entering READ in the 2111 field (in the 
HIP access window) causes the next value from the file to be 
transferred to the HDR and the status to be set as if the ADSP-21xx 
read the value. Entering READ in the Host field of an HDR causes its 
value to be transferred to the associated output file, if it exists, and the 
status to be set as if the host read the value. 
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11.4.4.1 Opening A File For HIP Data Transfers 


You must explicitly assign a file to an HDR and open it before the HDR 
can read or write to it. There are two ways to open a file for the HIP; 
you can open files by entering the names directly in the HIP files 
window, or by typing syntax in the command window. 


To assign a file to the HDRs through the HIP files window: 


1. Select HIP Files, from the File menu. This displays the HIP files 
window shown in Figure 11.7. 


2. Complete the following fields for each SPORT: 


Input file Input file data is read from (include file extension) 
Output file | Output file data is written to (include file extension) 
Circular (input files only) Specifies whether or not the file 


pointer is wrapped back to the top of the file when 
an end-of-file (EOF) condition is detected; enter “Y” 
or sal «a 


You can use the mouse or T, J, 3, <, keys to select the fields and 
options. Type in the filenames with the file extensions, then press 
Return. 


Note: The input file must already exist, but the simulator creates the 
output file for the HIP. 


To assign files to the HDRs from the command window: when you 
want to read from an HDR, use the Hipread (HIPR) command in the 
form: 

> hipread hdr# >‘outfile’ 

or 

> hipr hdr# >‘outfile’ 

where /hidr# is HDRO-HDR5 (source of the data) and outfile.ext is an 


output file, with an optional extension, enclosed in single quotation 
marks. 
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Figure 11.7 HIP Files Window 


When you want to write to an HDR, use the HIPwrite (HIPW) 
command in the form 


> hipwrite hdr# <‘infile’ 

or 

> hipw hdr# <‘infile’ 

where hdr# is HDRO-HDRS (destination of the data) and infile.ext is an 


input file, with an optional extension, enclosed in single quotation 
marks. 
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/O Operations 


11.4.4.2 Generating Host Reads & Writes 


To enable automatic generation of HIP writes (simulating 
asynchronous data transfers from the host), enter this command in the 
command window: 


> hipwrite hdr# min [max] [offset cycles] 


where hdr# is HDRO-HDR5 (destination of the data), min is the 
minimum period (in clock cycles) between interrupts; max, (optional) is 
the maximum number of clock cycles between writes and cycles, the 
number of clock cycles that must elapse before the first write occurs. 


Similarly, the command to generate automatic HIP reads (transfers to 
the host) is 


> hipread hdr# min [max] [offset cycles] [nowait] 


where hdr# is HDRO-HDR5 (source of the data), min the minimum 
number of cycles between interrupts, max is the maximum number of 
cycles between interrupts and cycles is the number of cycles to wait 
before starting interrupts. 


The optional nowait causes the host to read from the HDR at the 
programmed frequency, even if the value has not changed from the 
previous read. If nowait is not specified, the output file will be 
updated only if the ADSP-21xx has written the HDR since the previous 
read. This simulates a host using status signals to determine that new 
data is ready. 


For example, to output data from the HDR1 register to the simulated 
host (represented by the file outdata.dat) every 50 cycles, but only if 
there is new data to transfer, enter these commands in the command 
window: 


> hipr hdrl >‘outdata.dat’ 
> hopr harl 50 


To output data from the HDR2 register to the file outdata2.dat every 75 
cycles, transferring data (new or old) every time, enter these 
commands in the command window: 


>hipr hdr2 >‘outdata2.dat’ 
>hipr hdr2 75 nowait 


To write data to the HDRO register from the simulated host 
(represented by the input file indata.dat) every 1000 to 2000 cycles, 
starting after 5000 cycles have elapsed, enter these commands in the 
command window: 


>hipw hdrO <‘indata.dat’ 
>hipw hdrdO 1000 2000 offset 5000 


11.5 = ANALOG INTERFACE (ADSP-21MSP50) 


To simulate the analog interface of the ADSP-21msp50, you can 
examine and change the values of the memory-mapped registers 
associated with its operation. You can also simulate sending and 
receiving analog signals by associating data files with the analog 
transmit and receive registers. This section describes commands and 
windows used in analog interface simulation. 


11.5.1. Analog Interface Registers Window 

Figure 11.8 (on the next page) shows the analog interface registers 
window. You can alter the contents of these register bit fields in two 
ways. First, when the analog interface registers window is active you 
can enter the desired value by moving the cursor to that field and 
typing the new value. When you press Return, the new value replaces 
the old value. 


The second method for changing a register is to enter a command (in 
the command window) of the form 


> register = expression 


where register is the name of the register field and expression is the 
value to be entered. For example, 


> dactran=0x00fFf 


writes the value OxOOFF to the D/A converter transmit register, 
DACTRAN. 
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Analog Interface (Hex) 
DACTRAN : 
ATBUF : 
ATIREG: 
ATMREG : 
PDFORCE : 
XTALDIS: 
IMS : 


DABY : 
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Figure 11.8 Analog Interface Registers Window 


The fields in the analog interface registers window are defined as 
follows: 


ADCRECV Receive (ADC) data register (16 bits) 
DACTRAN _ Transmit (DAC) data register (16 bits) 


ARBUF Receive autobuffer enable bit 

ATBUF Transmit autobuffer enable bit 

ARIREG Receive autobuffer I register select bits (3 bits), sets up 
the index register for circular buffering 

ATIREG Transmit autobuffer I register select bits (3 bits), sets 


up the index register for circular buffering 
ARMREG Receive autobuffer M register select bits (2 bits), sets 
up the modify register for circular buffering 


ATMREG Transmit autobuffer M register select bits (2 bits), sets 
up the modify register for circular buffering 
PUCR Powerup context reset enable bit, determines if stacks 


are cleared when processor exits the powerdown 
interrupt (if set to 1, stacks are cleared) 

PDFORCE Powerdown force bit, forces the processor to vector to 
the powerdown interrupt 
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The following bits do not affect the operation of the simulator. They are 
for display purposes only. 


XTALDELAY Cycle delay after exiting powerdown 


XTALDIS XTAL pin disable, disables XTAL during powerdown 
IPS ADC input preamp select bit 

IMS ADC input mux select bit 

OG0-OG2 DAC output gain select 

APWD Analog interface powerdown bits 

ADBY ADC high-pass filter bypass bit 

DABY DAC high-pass filter bypass bit 


11.5.2 Sending & Receiving Data From Files 

The analog interface contains A/D and D/A converters that allow the 
processor to send and receive analog signals. The simulator cannot 
simulate analog signals. However, it can capture the data sent to the 
analog transmit register directly into a file, and it can read data from a 
file directly into the analog receive register to simulate data flow in the 
analog interface. There are two ways to accomplish this simulated 
analog data transfer. 


First, you can use the Open Port pop-up window: 
1. Select Open, located under Port Display, in the Memory menu. This 
displays the pop-up window shown in Figure 11.9, which can be 


found on the following page. 


2. In the pop-up window, complete the following fields: 


Memory Port defined as PM or DM in the architecture file 
Address Port address defined in the architecture file 

File Format Hexadecimal, fixed-point, floating-point data format 
Autowrap (input files only) Specifies whether or not the file 


pointer is wrapped back to the top of the file when 
an end-of-file (EOF) condition is detected; also 
referred to as “circular” files 
Input Input file data is read from (include file extension) 
Output Output file data is written to (include file extension) 


You can use the mouse or 1, J, 3, <, keys to select the fields and 
options. Type in the filenames with the file extensions. Then press 
Return. 


Note: The input file must already exist, but the simulator creates the 11-23 
output file. 
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Port Open Menu 
Memory Address File Format Autowrap Input Filename Output Filename | 


in_data.dat out_data.dat 
Accept Port Configuration? 


YES NO 
Enter memory type 


ommand Window (Hex) 
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Figure 11.9 Pop-up Window For Opening Ports 


Second, you can enter the Openport (OP) command in the command 
window: 


> openport address [>'’outfile’] [<’‘infile’] 


where address is a standard address or symbolic name for the analog 
interface register, outfile is the name of a file that collects the output 
data and infile is the name of a file that supplies the simulated 
inputs. The ADC receive register must be associated with an input 
file; the DAC transmit register must be associated with an output 
file. 


For example, to set up the analog transmit register to send data toa 
file, enter this command in the command window: 


> openport Ox3FEC >’‘outfile’ 


where outfile.ext is the file name. 
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I/O Operations 11 


To set up the analog receive register to receive data from a file, enter 
this command: 


> openport Ox3FED <‘infile’ 


where infile.ext is the name of a file. 


Note: When you access an analog interface register from the command 
window, the simulator sets the register to read and write the input and 
output files in the current data format of the command window 
(hexadecimal or decimal). Other data formats are supported. If you 
want specify data files as fixed- or floating-point, use the pop-up 
window described above. These formats are described in Appendix B, 
File Formats. In hexadecimal and decimal formats, data is sent and 
received unchanged. In floating-point format, however, output data is 
scaled to the range +1.578 to -1.578 to simulate the range of the analog 
output. 


Once you associate a file with either analog register, data transfers 
occur at a fixed rate. On an actual device, the rate is 8 kHz. In the 
simulator, the default transfer rate is every 1625 cycles. To change the 
transfer rate, use the Codeccycles (CC) command in the form 


> codeccycles #cycles 

or 

> cc #cycles 

where #cycles is the new period in cycles. 


11.5.3 Checking Analog Interface Register Status 

You can check the status of the analog interface registers from the port 
display window (shown in Figure 11.10, on the next page). This 
window shows you the analog interface registers and displays the 
attributes associated with each. This window is only a status window, 
you cannot open, close, or change registers from this window. To 
display the port display window, select Port Display from the Memory 
menu. 
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Port Display 
Memory Address File Format Autowrap Input Filename Output Filename | 


xin.dat out_data.dat 
yin.dat dac_out.dat 


ommand Window (CHex) 
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Figure 11.10 Port Display Window 


11.5.4 Closing Simulated Data Transfer Files 


There are also two ways to close the simulated analog data files; you 
can close them from the pop-up window or from the command 
window. 


To close the transfer files from the pop-up window: 


1. Select Close, located under Port Display, in the Memory menu. This 
displays the pop-up window shown in Figure 11.11. 


2. Select a register with the T and J keys or with the mouse. Then press 
Return. The associated file is closed and the file buffers are flushed. 


To close the transfer files from the command window, enter the 
Openport command and register address without file arguments, for 
example: 

> openport dm(0x3FEC) 


closes the data transfer file associated with the analog transmit register. 
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Port Close Menu 
Memory Address File Format Autowrap Input Filename Output Filename | 


4644 in. out_data.dat 
4601 in. dac_out.dat 


Select port to close or <ESC> to abort 


ommand Window (Hex) 
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Figure 11.11 Pop-up Window For Closing Ports 
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Miscellaneous Functions 


12.1 SAVING & ENDING A SIMULATOR SESSION 


When you end a simulator session, you can save the state of the 
simulation and continue working later from the same point where you 
stopped. There are two ways to end a simulator session and return to 
the operating system: exiting and quitting. 


e When you exit ,the simulator updates the default window 
configuration (.WIN) file to reflect the current screen configuration. 
This command preserves the physical attributes of the display, such as 
the number of open windows, their size, position, data format, etc. The 
next time you start the simulator, the default file is automatically 
loaded. 


e When you quit, the simulator does not update the .WIN file, so changes 
to the screen configuration since the start of the current session are not 
preserved. 


12.1.1 Custom Window Configuration Files 

When you exit from the simulator, the default window configuration 
file is automatically updated to reflect the current window 
configuration. The default file is automatically loaded the next time 
you start the simulator. If you want to save a custom window 
configuration, you must select Save Window File from the File menu, or 
use the Win command in the form 


> win >’filename’ 
Note: A custom window configuration file must be explicitly updated. 


If you load a custom .WIN file and then exit, only the default file is 
updated. 
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If you want to start the simulator with a specific display configuration 
other than the default, you must use the -w switch and specify the 
filename of your preferred configuration when invoking the simulator. 
For example 


>s1im2101 -w custom 


starts the ADSP-2101 simulator with the custom.win configuration 
file. 


Once you start the simulator, you can change the current window 
configuration by selecting Load Window File from the File menu, then 
entering the name of the new .WIN file in the pop-up window. 


12.1.2 Saving The Simulation State 


Individual commands save parts of the simulation state. You can save 
the following: 


e Selected ranges of memory to files using Dump Memory from the 
Memory menu, or the Dump (D) command in the form 


> dump addr|range >' filename’ 


For a more complete description of this command, see Chapter 9, 
Registers and Memory. | 


e Currently defined aliases using the Alias command. 
> alias >’filename’ 


You can also save and restore the whole state of the simulator with the 
State command. When you save the state of the simulator, the 
following items are preserved: 


Contents of all registers 

Contents of all memories 

Defaults as listed in the defaults window 
Symbols 

Breakpoints 


Specify the file to write to or read from and the direction of the transfer 
using > and < as direction operators. To write the current state of the 
simulator to a file, you enter the command 


> state >‘filename’ 
The filename is enclosed in single quotation marks. 


To restore the state of the simulator from a file (after rebooting or 
resetting, for example) you enter the command 


> state <‘filename’ 
which restores the simulator to the previous state. 


The State command does not save the items listed below; you must be 
re-create them after state restoration: 


All general, break, and watch expressions 

Aliases (but you can store these in a file using the Alias command) 
Trace information 

Profile address ranges and data 

Pointers to data files used to simulate HIP, SPORT and I/O port 
activity. You must re-open all data files. 


12.2 | EXECUTING OPERATING SYSTEM COMMANDS 


You can temporarily suspend operation of the simulator and exit to the 
operating system, or you can execute a single operating system 
command without leaving the simulator. Because the simulator 
requires a large amount of memory, you might not be able to execute 
any other programs if your platform is a PC. However, you should be 
able to rename files, copy files, inspect directories and execute other 
intrinsic DOS functions with no difficulty. This operation changes no 
values in the simulation. 


To exit to the operating system: 
1. Select Operating System Shell from the File menu 
or 
2. In the command window, use the Shell (GH) command: 


> shell 
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‘unctions 


To return to the simulator, type "exit" at the operating system prompt. 


For the Shell command to work properly on a PC, your COMMAND .COM 
(DOS) file must be in the current or top-level directory, or a PATH 
statement must be defined leading to the directory containing it. 


To execute a single operating system command: 


1. Select Shell an OS Command from the File menu, then enter the 
command in the pop-up window and press Return. 


Or 


2. On a PC, the Shell command can take a DOS command (inside 
single quotes) as an argument. This combines three actions into one: 
entering the Shell command, entering the DOS command and 
entering Exit. For example 


> shell ’copy @:\Z101\Eilter.dsp ¢:\old\fir.dsp’ 


causes the simulator to exit to DOS momentarily, executes the Copy 
command, and returns to the simulator. 


If your PC does not have extended memory, however, you will not be 
able to execute all DOS commands in this fashion. 


12.3. VIEWING TEXT FILES 


The file viewing window lets you view any text file while running the 
simulator. To view a file, select Display File from the File menu, then 
enter the filename in the pop-up window and press Return. 


You might use this window, for example, to look at your .SYS 
architecture definition file while working in the simulator. Figure 12.1 
shows an example of the file viewing window used for this purpose. 
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examplei.sus 
.SYSTEM example: 
-ADSP2161;: 
. SEG’ PMRAM ABS =6/CODE/DATA ext_pm([26481; 
. SEG/DMRAMABS =14336/DATA int_dml16241; 
- PORT“DM“ABS =-6 Zz out; 
.PORT/DM“ABS=1 in_port;: 
.ENDSYS:; 


ommand Window (Hex) 
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Figure 12.1 File Viewing Window 


12.4 THE ? COMMAND & EXPRESSIONS WINDOW 


The simulator’s ? command and expressions window are general 
purpose debugging tools which evaluate any valid expression. You 
can use them like a calculator to derive the numerical value of any 
expression built from simulator variables. 


12.4.1. The Expressions Window 

The expressions window can display and evaluate expressions while 
you perform other debugging actions. Register and memory contents 
can be used in expressions, and the simulator will update an 
expression’s value as it changes during program execution. 

To open the expressions window, 


-Select Expressions from the Misc menu. 
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Type your expressions in, one per line, and press Return after each. 
The expressions window maintains each defined expression, updating 
and displaying its value as you perform other actions in the simulator. 
Expressions added to this window are numbered from 0 to 9; you can 
have a total of 10 active at any time. 


You can also add and delete expressions from the expressions window 
by using the ?+ and ?- commands in the command window: 


> ?+ expr add expression to expressions window 
> ?- expr# delete expression # from expressions window 


Figure 12.2 shows an example of the expressions window created by 
first entering the expression 


ar + ax0 

directly in the expressions window and then giving the command 
> ?+ ayO - ax0 

in the command window. 


Hexadecimal values calculated in the expressions window are shown 
as sign-extended, 32-bit numbers, without leading zeros on positive 
numbers. 


12.4.2 Evaluating Expressions With The ? Command 


The ? command is used to quickly evaluate any expression from the 
command window, without adding it to the list of defined expressions 
in the expressions window. The ? command has the following syntax: 


> ? expr evaluate expression 


The simulator returns the value of the expression in the command 
output window. In Figure 12.2, for example, the second line in the 
command window 


> ? ar + dm(0x0000) 
produced this result 
AR+ DM[0O] = 60 


in the command output window. 
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[6] AR+AX 
C1] AYH-AXH = Bxa 


Data Memory (Hex) 
2 _OUT: 
PORT [6666] 461e 
———-— [8661] uuu 
—-——— [6662] uuu ommand Window (Decimal )———, 
> 7+ ay — ax a 
> ? ar + dm(6x6668) 
Computational Registers (Hexadecimal) > 
active 
: 68a AX1: uuu AR: 661e 
: 6614 AY1: uuu AF: uuuu 


: : Command Output Window 
> uuuu MX1: uuu e JpR+anta1 = 66 | 
> uuu MYL: uuu MF: uuu 


> LUULULLL MR1i: uuuu MR2Z: uu 
> LUULULLL SRi: uuu 
ULL SE: uu SB: uw 
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Figure 12.2 Expressions Window 


In this example, DM(0x0000) is evaluated to be the data contained at 
address 0 rather than the address itself. This illustrates the difference 
in how the simulator interprets an address given in an expression. If 
used in an expression which must evaluate to a numerical value, 
DM(address) denotes the contents of the memory location. If it is part of a 
command where the simulator expects an address, DM(address) 
denotes the address itself. 


One good use of the ? command is to quickly determine the value of a 
register or memory location, for example: 


> ? ax0 
= 7 cdm[ 55] 


12-7 


12-8 


Functions 


Miscellaneous 


12.4.3 Locating Symbols With The ? Command 


The ? command, given in the command window, can also locate 
program symbols (variable names and address labels). To locate a 
symbol, enter 


> ? symbol 


where symbol is any symbol you believe is defined in your program. 
For example, to find the label routine3, enter the command 


> ? routine3 
The simulator’s response would look like this: 
routine3=0x37 


Remember that labels are case-sensitive in the simulator. If you enter 
ROUTINES when the actual label is routine3, it cannot be found. 


12.4.4 Allowable Operands & Operators 


Simulator expressions can be built with the following operands: 


program symbols (variable/buffer names, address labels) 
register contents 

memory contents 

simulator-maintained software registers: 


ig @ program counter 
CNTR loop counter 
CYCLE instruction cycle counter 


PM_ADDR last program memory address accessed 
DM_ADDR last data memory address accessed 


(These values are shown in the program control registers window.) 


Miscellaneous Functions 


The simulator, unlike the assembler, recognizes the complete set of C 
language operators. In order of precedence, the operators are: 


( ) left, right parenthesis 

[~ - logical NOT, ones complement, unary minus 
+ | % multiply, divide, modulus 
+ - addition, subtraction 

<< >> bitwise shifts 

< > <= >= _ relational operators 

== I= . 1s equal, is not equal 

& bitwise AND 

| bitwise OR 

7 bitwise XOR 

&& logical AND 

| | logical OR 


Here are some examples of simulator expressions: 


AXO && AX1 The logical AND of the values in 
AX0 and AX1 
(DM(taps + 16)% AR) - 3 The product of the value in the 


data memory location at address 
(taps+16) and the value in AR, 
less 3 


DM(coeff) ==0x0035 The (logical) condition that the 
data memory location at address 
coeff contains the value 0x0035 


12.5 COMMAND ALIASES 


Aliasing commands—the substitution of different mnemonics for the 
simulator’s native command set—lets you customize commands to suit 
your own needs and preferences. 


12.5.1. Creating Aliases 
The aliasing command is entered in the command window and follows 
the syntax 


> alias ‘newname’ ‘command’ 


12 
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or 


> alias ‘newname’ ‘command [;commania ...] ' 

where alias is the simulator aliasing command, newname is the alias 
and command is any legal simulator command. The alias can represent 
a single command or a series of commands. If more than one 
command is specified, they must be separated by semicolons. The alias 
and command(s) must be enclosed in single quotation marks. 

For example, the command 


> alias ‘setbrk’ ‘b pm(0x0035); b pm(0x0100) ’ 


creates the alias setbrk that sets breakpoints at PM addresses 0x0035 
and 0x0100. 


You can pass up to ten arguments to aliased commands using “$1”, 
“$2”, etc., as the arguments. For example, the simulator command to 
write the value 40 into data memory location 0x2FF is 

> fill dm(0x02FF) 40 

which can be aliased to the symbol SETDM by entering this command: 
> alias ‘setdm’ ‘fill dm($1) $2’ 

Now the command 

> setdm Ox02FF 40 

is executed as 


> fill dm(0x02FF) 40 


If a filename is part of the command to be aliased, enclose the filename 
itself in double quotes, as in: 


> alias ‘loadpgm’ ‘load “calc”’ 


12-10 


12.5.2 Showing Current Aliases 

The Alias command, given with no arguments, lists all currently 
defined aliases in the command window. This is useful for managing 
command aliases as they become more numerous. Aliases are listed in 
the command window in the form 

symbol = command 


where symbol is the name you assigned as the alias and command is the 
actual command executed by the alias. 


12.5.3 Deleting Aliases 


The Delete command deletes an alias. The form of this command is 
> delete ‘symbol’ 


where symbol is a currently defined alias name. The alias is deleted 
from the list. 


12.5.4 Saving Aliases 


You can save the list of currently defined aliases to a file for reference 
and editing with the command: 


> alias >’filename' 


The contents of the text file created by this operation are actual Alias 
commands, like those executed to create the aliases, such as: 


alias ‘setpc’ ‘pc=$1' 
alias ‘view’ ‘win < “myscreen”’ 
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Invoking The Simulator 

SIM2100 for ADSP-2100A 

SIM2101 for ADSP-2101, ADSP-2105, ADSP-2115 
SIM2111 for ADSP-2111 

SIM2150 for ADSP-21msp50/51/55/56 


VV VV 


Invocation Line Switches 


> SIM21xx [-a filename] [-c] [-e filename] [-k filename] 
[-w filename] [-o filename] [-help] 


-a filename Specify .ACH architecture file (default=210X.ACH) 

=e Make simulator case-sensitive for assembly code 
symbols 

-e filename Load program (.EXE file) 

-k filename Loadand run keystroke file 

-w filename Start simulator with .WIN windows configuration file 

-o filename Open ASCII output file to capture simulator error 
messages and command output window messages 

-help Display invocation syntax and command line switches; 
simulator is not invoked 


example: 
> sim2101 -a dspsys 


General-Purpose Program Control 

Registers Registers 

HOLDER1 PC 

HOLDER2 CNTR 

HOLDER3 CYCLE 

HOLDER4 PM_ADDR 
DM_ADDR 


Table 13.1 Simulator-Maintained Software Registers 
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13 Command Reference 


Command 

alias ‘newname’ ‘cmd’ 
alias >’ filename’ 
alias 

addsymbol+ ‘symbol’ addr 
{asym+ } 

assemble addr instr 
{a} 

break addr 

break addr, n 

break 

{b} 

breakchange expr 
1c } 

breakdelete break# 
{bd } 

breakdelete ALL 

{bd } 

breakexpression expr 
{be} 

breakrange range 
{br } 

chipreset 

LCE} 

codeccycles #cycles 
Lec} 

connect rfs# tfs# 


connect rfs# tfs# OPEN 
connect ALL OPEN 
connect 

delete ‘newname’ 

dump range >’ filename’ 
{d} 

execute instr 

{exe } 

find addr,addr expr 
{f} 

fill addr expr 

fill range expr 

fill startaddr <’ filename’ 
go 

go addr 

{g} 
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Definition 

Create command alias 

Save aliases to file 

List aliases in command output window 
Add program symbol at address 


Assemble instruction at address 


Set breakpoint 
Set multi-breakpoint 


List all breaks in command output window 


Set break change expression 
Delete break 

Delete all breaks 

Set break expression 

Set break address range 

Chip reset (with program boot) 


Set data transfer rate for analog interface 
(ADSP-21msp50) 

Connect RFS of SPORTx (rfs#) to 

TFS of SPORTY (tfs#) 

Disconnect RFS-to-TFS connection 
Disconnect all RFS-to-TFS connections 
List current RFS-to-TFS connections 
Delete alias 

Dump memory to file 


Execute instruction 


Find numeric value (expr) in memory range 


Set memory location to value (expr) 
Fill memory range with value (expr) 
Fill memory range from file 

Start program execution 

Start program execution, stop at addr 


Command 

hipboot ‘filename’ 

{hb} 

hipread hdr# >'outfile’ 


Chapter 


10 


11 


hipread hdr# min [max] [OFFSET #cycles] [nowait] 11 


{hipr} 

hipwrite hdr# <'infile’ 

hipwrite hdr# min [max] [OFFSET #cycles] 
{hipw} 

interrupt irg# min [max] [OFFSET #cycles] 
interrupt sig min [max] [OFFSET #cycles] 
interrupt FI period [ONCE| RESET] 
interrupt ALL 

interrupt ACTIVE 

ii} 

keyon ‘keyfile’ 

{ko} 

keyoff 

{kf} 

<'keyfile’ 

load ' filename’ 

{1} 


loadrom ’ filename’ 


1 Le I 

loadsymbols ‘filename’ 
{ls} 

loopback sport# 

{lb} 


loopback sport# OPEN 

loopback ALL OPEN 

loopback 

{ Lis} 

openport addr [<’infile’] [>’outfile’ ] 
{op} 

openport addr <’infile’ CIRC 

{op } 

openport addr 

{op } 

opensport sport# [<’'infile'’] [>’outfile’] 
opensport sport# <'infile’ CIRC 
opensport sport# 

{os } 


Lt 
11 


10 
11 
10 
10 
10 


Definition 
Read .HIP boot file into simulator 


Open file for output from HIP data register 


Generate periodic HIP read (by host) 


Assign file for input to HIP data register 
Generate periodic HIP write (from host) 


Generate periodic interrupt signal 
Generate periodic serial port signal 
Generate periodic Flag In signal 
List settings for all signals 

List settings for all active signals 


Start recording keystroke file 
Stop recording keystrokes, close file 


Playback keystroke file 
Load program (.EXE file) into memory 


Load ROM file (.BNM file) into boot 
memory 

Read new symbol table (SYM file) into 
simulator 

Connect TFS to RFS and DT to DR 
of serial port 

Disconnect loopback connection 

Disconnect all loopback connections 

List current loopback connections 


Open memory-mapped I/O port and 
assign data files 

Open memory-mapped I/O port with 
circular input data file 

Close memory-mapped I/O port 


Open SPORT and assign data files 
Open SPORT with circular input data file 
Close SPORT 


(table continues on next page) 
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Command 

plot range decimation 
ipl} 

profileadd range# addr, addr 
{pa} 

profileclear 

{pc} 

profiledelete range# 
{pda} 

profilereset 

{pr} 

resetnoboot 

(pe) 

shell 

{sh} 

state >’ file’ 
state <’ file’ 
step 

step n 

{s} 

undefine reg 
undefine addr 
undefine range 

Lu} 

watchdelete watch# 
{wd } 
watchexpression expr 
{we } 

watchpoint addr 
watchpoint range 
watchpoint 

{w} 

win »>’file’ 

win <’file’ 

2 expr 

? reg 

2? addr 

2? symbol 

2+ expr 

?- expr# 

reg = expr 
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Definition 
Plot memory data 


Define (or redefine) profile address range 
Clear all profile data, delete all address ranges 
Delete profile address range 

Clear all profile data, retain address ranges 
Reset chip, without program boot 


Temporarily exit to operating system 
(type “exit” to return to simulator) 

Save simulator state 

Restore simulator state 

Single step 

Multi-step 1 instructions 


Undefine contents of register 
Undefine contents of memory location 
Undefine contents of memory range 


Delete watch# 
Set watch expression 


Set watchpoint on data variable or buffer 
Set watch address range 
List all watches in command output window 


Save windows configuration (.WIN file) 
Restore windows configuration (.WIN file) 
Evaluate general expression 

Evaluate contents of register 

Evaluate contents of memory location 
Locate program symbol 

Add expression to expressions window 
Delete expr# from expressions window 

Set register equal to value of expression 
(ex. AX0=0xFF) 


Short form of command: command chipreset 


{ cmd} (ox } 
To define an address range: range = startaddr , endaddr 
range = startaddr / #locations 


Table 13.2 Command Window Commands 


Ctrl-D Dump memory to file (in any memory window) 

Ctrl-F Fill memory (in any memory window) 

Ctrl-G Goto address (in any memory window) 

Ctrl-L List open windows and choose one to bring to front 

Ctrl-M Load memory (in any memory window) 

Ctrl-R Read from host (in HIP Registers Window); Resize trace length (in 
Trace Window) 


Ctrl-T Toggle numeric format in window (decimal < hexadecimal) 


Table 13.3 Control Key Sequences 


[Boot Memory 17 — 
DataMemory sd IV 
Program Memory |v |W [v |v | |v 
[Analog Interface Registers__[ [|_| | [7 
[Computational Registers [|_| | | | 
mca 


(Control Registers _—_—+| | |_| __ 

DAG Registers ———-+| | |_| 

HiPRegisters———+i|_—+| | | (77 
Program Control Registers |_| | | | [7 
SPORT Registers |_| | | | [7 
a 
[Command Window |_| | | | 7 


[Expressions Ci TT | 
Profile Ss 


Table 13.4 Window-to-Control Key Cross Reference 
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Function 
Key 


Shift-F5 
Shift-F6 
Shift-F7 
Shift-F8 
Shift-F9 
Shift-F10 


Escape 


Function 
Help 


Goto Next Window 
Goto Menu Bar 
Run (Go) 


Move Window Up 7 
Move Window Down J 
Move Window Left <— 
Move Window Right > 
Set/Clear Breakpoint 
Single Step 


Enlarge Window Vertically t 
Reduce Window Vertically 

Enlarge Window Horizontally <—> 
Reduce Window Horizontally — < 
Set/Clear Multi-Breakpoint 
Multi-Step 


Close window 


Table 13.5 Keyboard Function Keys (PC only) 
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Instruction Coding 


A.1 OPCODES 

This appendix gives a summary of the complete instruction set of the 
ADSP-2100 family processors. Opcode field names are defined at the 
end of the appendix. Any instruction codes not shown are reserved for 
future use. 


Type 1: ALU/MAC with Data & Program Memory Read 


43 24 21 40 19 16 17 16 15 168 13 l2 Jd. I0 SBT 6é 5B ASB a 1 


Type 2: Data Memory Write (Immediate Data) 


23 44 41 40 19 18 17 16 15 14 13 i2 t412 10S 87 6b Ag ai 
1 QO d1| G DATA 1, M 


Type 3: Read /Write Data Memory (Immediate Address) 


243 42 21. 20 19 18 17 16 15 14 13 12 11 109 8 7654321 0 
1 O QO} D}| RGP ADDR REG 


Type 4: ALU/MAC with Data Memory Read / Write 


Type 5: ALU/MAC with Program Memory Read / Write 


4245 424 41 20 13 18 17 16 15 14 13 f2 11 1098 FES 424321 


0 1 0 1|\ Di z AMF Yop | Xop | DREG I| ™M 


A 


Instruction Coding 


Type 6: Load Data Register Immediate 


23 a2 21 20 19 18 17 16 15 14 13 12 11 10 9 BF 65432 1 20 


O 1 0 O DATA DREG 


Type 7: Load Non-Data Register Immediate 
23 22 21 20 19 18 17 16 15 1413 1211109 876543210 


0 0 1 4) RGP | DATA REC 


Type 8: ALU/ MAC with Internal Data Register Move 


oO 1 0 1) 2 AMF Yop Xop Dest Source 
DREG DREG 
Type 9: Conditional ALU / MAC 


23 22 21 20 19 18 17 16125 14 13 121110 9 8BT765432i1 0 


Type 10: Conditional Jump (Immediate Address) 


25 2221 20 19 18 17 16 15 14 13 1211 103 8765432 1:0 


Type 11: Do Until 


23 ge 21 20 19 18 417 16 15 14 313 1241140 SSTées 4s2i1 0 


Type 12: Shift with Data Memory Read / Write 


23 22 21 20 19 18 17 16 15 14 13 12 11°10 9B 7654321 0 


Type 13: Shift with Program Memory Read / Write 
23 22 21 20 19 18 17 16 15 14 13 12 11109876543210 
0001 0 00 1/D SF Xop | DREG | I| M | 
Type 14: Shift with Internal Data Register Move 


ao 24 2) AU 19 12417 16 15 14 13 t2 J 10 FP 8676S AS ALO 


0 OO 0 1 8@ BQO 0 O SF Xop Dest Source 
DREG DREG 


Type 15: Shift Immediate 


43 a2 21 20 19 18 17 16 IS t# tp dA AU eB oT 6G FAS a 1 CD 


0 © @Gidlidstidai id SF Xop exponent 


Type 16: Conditional Shift 


23 24 21 20 19 18 17 16 15 14 13 12 ti 210 83 BY 6 5b ASB 21 OO 


Type 17: Internal Data Move 


23 22 21 20 19 18 17 16 15 141312111098 76543210 


0 0 0 0 21 3212 0 1 0 0 0 #0] DST |} SRC} Dest Source 
RGP | RGP| REG REG 


Type 18: Mode Control 


poo oo 11 0 0] MY] wm] as] oof or] sm] avo o 


Definitions for the field names shown (TI, MM, AS, OL, BR, SR, GM) can be found 
under “Mode Control Codes’ at the back of this appendix. 


Type 19: Conditional Jump (Indirect Address) 


2s 24 44 20 19 18 17 16 15 14 13 da ii 10 876543 2 1 0 


Type 20: Conditional Return 


Zo 24 214 29 19 le ly 16 15 14 13 12 1i 10 


Type 21: Modify Address Register 


23 22 21 2019 18 17 16 15 1413 12 11109876543210 
000010010 00 0 0 000000 c] rf mM | 
Type 22: Conditional TRAP (ADSP-2100 Only) 
23 22 21 20 19 18 17 16 15 14 13 1211109876543210 
000 010 00 0 0 0 0 0 000000 0] conD 


Type 23: DIVQ 


Type 24: DIVS 
23 22 21 20 19 18 17 16 15 1413 12 1110987654321 0 
0 0 0 0 0 1 1 0 0 0 Of} Yop Xop 0000000 0 
Type 25: Saturate MR 


23 422 21 20 19 18 17 146 15 1413 J2dLiv 9g BF ESB ABA 1 
0 0 OO 0 0 1 @ tod 0 O@ 0 @BOC00002 0 00D 


Type 26: Stack Control 


As 24 21. 20 19 18 T7? 16 15 74 13 12 il 10 654 3 
0 0 


210 
000 0 01 0 0 0 0 0 0 PP| LP| CP] SPP | 


Type 27: Call or Jump on Flag In (Not ADSP-2100) 


23 22 21 20 19 18 1716 15 1413121110987654 32 1 0 
00000011 Address 


12 LSBs 2 MSBs 


Type 28: Modify Flag Out (Not ADSP-2100) 


23 22 21 2019 18 17 16 15 14 13 1211109876543210 
000 00010 0 0 0 0 FO |FO |FO |FO | COND 


FL2 FL1 FLO FLAG OUT 
Type 29: Reserved 


23 22 21 20 19 18 17 16 15 14 13 1227 310 9 8 7 6 5 A B21 
0 8 68 U0 8G @ Le KR KeMhCUP;HRMC KMChUCU RR KRKRHXRMRAHRRAR 


Type 30: No Operation (NOP) 


2s 22 24 20 19 18 17 16 15 14 db da dl iv ger ese Sal CD 
0 0 0 0 0 0 0 0 0 0 0 00 000000000 0 0 


Type 31: Idle (Not ADSP-2100) 


aa 22 21 20 19 18 17 16 15 14 13 12 il 2b 
0 0 0 0 0 0 1 0 1 0 +0 


Type 32: Slow Idle (Not ADSP-2100) 


23 22 21 20 19 18 17 16 15 1413 lz2@iligv0g 8 ?F?be543210 
0 0 0 0 0 0 1 0 1 0 0 0 0 000000 0 DV 


A Instruction Coding 


ABBREVIATION CODING 


A.2 


ALU / MAC Function codes 


AMF 


No operation 


000 0 0 


MAC Function codes 


=0 


=> 

cC 

eb) 

< 

= 

o 

Oo 

c> 
‘in te te. CO) =a Ce 2 CD) 2d OO) a 2 oD) 2 
CeTCAMAHDDZARNADAWBZANANFDF 
- > -~ ---— >>> > 
x 4 x *«£ © © FS ye & & 
~< >< HM XK XK XK EOD OK OK 
~ Fei eee ttt rs in 2 ts 
*« @DOoxe « «© « Ceeeeeece 
Kee xe MM Mee eae eee 
Aon ODA COA CO A OCOD OCOD O 
Onin OO FA oH OO A ot CO CO et ef 
Oo Ondo dtdti At TH OO CO Ot a ot ed 
OOO CO CO CO CO da titi oto tat ot A A 
ao Oo CO CO Oo CO OO Oo 2 GO 2 CO © 2G © 


ALU Function codes 


=0 


Clear wheri y 


Y 


1000 0 
10001 
10010 


=0 


PASS 1 when y 


Y +1 


X+Y¥+C 


=0 


X when y 


X+Y 


10011 
1010 0 
10101 
L19@ii1i0 
1oiu1id1t1 


NOT Y 
-Y 


=0 


X + C-1 when y 


X-Y+C-1 
X-Y 
Y-1 


=0 


PASS -1 when y 


1100 0 
11001 
11010 


=0 


- X when y 


Y -X 


=0 


-X+C-1wheny 


Y-X+C-1 
NOT X 


Lk OL dt 


COND 


CP 


PPP PR 


PRP PR 


PRPRP PR 


er © © 


ee © Fr © 


X AND Y 
X OR Y 
X XOR Y 
ABS X 


Status Condition codes 


eee Pr eR Po eo oe Oo oO OD oe © 


PP FH OO OC 8S. FF FY E Oo. &S © © 


EE oo FPF oOo Go FF © 6 FP fF GO Ge 


FPOrRPOrRPORPOrFRPRGrRFOFOFRO 


Equal 

Not equal 

Greater than 

Less than or equal 
Less than 

Greater than or equal 
ALU Overflow 

NOT ALU Overflow 
ALU Carry 

Not ALU Carry 

X input sign negative 
X input sign positive 
MAC Overflow 

Not MAC Overflow 
Not counter expired 
Always true 


Counter Stack Pop codes 


0 
i 


No change 
Pop 


Memory Access Direction codes 


0 
1 


Read 
Write 


DD 


DREG 


DV 


FIC 


Double Data Fetch Data Memory Destination codes 


AX0 
AX1 

MX0 
MxX1 


FF © © 
EO - © 


Data Register codes 


000 0 AX0 
0001 AX1 
001 0 MX0 
OO 14 MxX1 
O10 0 AYO 
O10 1 AY1 
O11 0 MY0 
01141 MY1 
100 0 S| 

1001 SE 
101 0 AR 
Lo dk MRO 
110 0 MR1 
iio id MR2 
1110 SRO 
Till SR1 


Divisor codes for Slow Idle instruction (IDLE n) 


0000 Normal Idle instruction (Divisor=0) 
0001 Divisor=16 

0010 Divisor=32 

0100 Divisor=64 

1000 Divisor=128 

FI condition code 

1 latched FI is 1 FLAG_IN 

0 latched FI is 0 NOT FLAG_IN 


FO 


LP 


Control codes for Flag Output Pins (FO, FLO, FL1, FL2) 


FO: Set, reset, or toggle the output flag. 
0 0 No change 

O01 Toggle 

1 0 Reset 

t 4 Set 


Data Address Generator codes 


0 DAG! 
ge DAG2 


Index Register codes 


Gs 0 1 
0 0 l0 4 
01 1 I5 
1 0 2 6 
1a 3 7 
Loop Stack Pop codes 

0 No Change 

| Pop 

Modify Register codes 

G= 0 1 
0 0 MO M4 
01 M1 M5 
1 0 M2 M6 
11 M3 M7 


SR: Secondary register bank 
BR: Bit-reverse mode 
OL: ALU overflow latch mode 
____ AS: _ AR register saturatemode 
MM: Alternate Multiplier placement mode (not ADSP-2100) 
GM: GOMode; enable means go if possible (not ADSP-2100) 
TI: Timer enable (not ADSP-2100) 
00 No change 
O01 No change 
1 0 Disable 
La Enable 
PD Double Data Fetch Program Memory Destination codes 
0 0 AYO 
O01 AY1 
1 0 MY0 
11 MY1 
PP PC Stack Pop codes 
0 No Change 
i Pop 


REG 


Register codes 


Instruction Coding A 


Codes not assigned are reserved for future use. 


PRPPERPRFPRFPRPRPODOCOAGOCCO 
PRPRPRPODOORPRRPRPROOCOO)!TU 
PROOrFRPRPRAOrFRPRFRAGODFRROAO 
FOoOrRPOrRPGFOFGRFOGFOFO 


Jump/Call codes 


00 
AX0 
AX1 
MX0 
MXx1 


11 

ASTAT 

MSTAT 

SSTAT (read only) 
IMASK 


| TX0 
I RX not ADSP-2100 registers 
I OXt 
| 

IFC (write only) 


A Instruction Coding 


SF Shifter Function codes 
60-2 0 LSHIFT (HI) 
0001 LSHIFT (HI, OR) 
0010 LSHIFT (LO) 
0011 LSHIFT (LO, OR) 
0100 ASHIFT (HI) 
0101 ASHIFT (HI, OR) 
0110 ASHIFT (LO) 
O111 ASHIFT (LO, OR) 
1000 NORM (HI) 
1001 NORM (HI, OR) 
1010 NORM (LO) 
10311 NORM (LO, OR) 
1100 EXP (HI) 
1101 EXP (HIX) 
11310 EXP (LO) 
11141 Derive Block Exponent 


SPP Status Stack Push/Pop codes 


0 0 No change 
O01 No change 
1 0 Push 
1 1 Pop 
T Return Type codes 
0 Return from Subroutine 
1 Return from Interrupt 


TERM 


Instruction Coding A 


Termination codes for DO UNTIL 


0000 Not equal 
0001 Equal 

0010 Less than or equal 
0011 Greater than 
010 0 Greater than or equal 
026 1 Less than 
0110 NOT ALU Overflow 
0111 ALU Overflow 
100 0 Not ALU Carry 
1001 ALU Carry 

101 0 X input sign positive 
10141 X input sign negative 
1100 Not MAC Overflow 
1. 2. Oe MAC Overflow 
111 0 Counter expired 
1221 Always 

X Operand codes 

00 0 X0 (SI for shifter) 
001 X1 (invalid for shifter) 
ut AR 

011 MRO 

1 0 0 MR1 

1g da MR2 

110 SRO 

1. i 4 SR1 


FOREVER 


A Instruction Coding 


j Y Operand codes 
0 0 YO 
01 Y1 
1 0 F (feedback register) 
i ob zero 
Z ALU/MAC Result Register codes 
0 Result register 
1 Feedback register 


File Formats 


B.1._ DATAFILES (.DAT) 


The .DAT file format is used for data buffer initialization. The format is 
generally the same for all uses, with some restrictions as detailed 
below. The .DAT extension is a DOS convention only and is not 
required by the linker. 


These files contain text only: the characters for hexadecimal, decimal, 
and binary data. Any standard text editor can be used to create the 
files. 


B.1.1. Assembler/Linker Buffer Initialization Files 

The .INIT assembler directive names a file from which to initialize a 
data buffer. You must create this file and specify it in source code with 
the .INIT directive. The file should be located in the directory from 
which the linker is invoked (the current directory), or the path to the 
file’s directory must be given in the .[NIT directive. The linker reads 
this file and initializes the buffer in the .EXE memory image file. The 
data file may be any length. 


B.1.1.1 Integer Data 


The standard format of a buffer initialization file is a single four- 
character or six-character hexadecimal number per line (carriage 
returns are ignored). ADSP-21xx data memory stores 16-bit words 
while program memory can store 16-bit or 24-bit data words. 


Buffer initialization files for data memory should contain four- 
character hexadecimal words. If a file for data memory contains six- 
character words, however, the four least significant characters of each 
number are used and the other two are ignored. For example, if your 
data file contains these lines: 


902222 
222 
220001 


The data loaded into memory is: 


ALLd 
Dee 
0001 


Files for program memory may contain four-character or six-character 
hexadecimal data words. If you are using four-character (16-bit) data, 
you must pad each data word with two zeros at the right to properly 
align the word in memory. For example, if your data is 


1234 
4321 


then the initialization file should contain: 


123400 
432100 


B.1.1.2 Non-Integer Data 


Buffer initialization files can contain decimal numbers with fractional 
components. However, these non-integer values are treated by the 
linker as integers; the fractional component is ignored (not rounded). 
For example, the value 5.862 is loaded in memory as 5. 


B.1.1.3 Comments 


Comments can be placed on each line in a buffer initialization file, 
anywhere to the right of the data. The comments must be enclosed in 
brackets: {comment }. 


B.2 | MEMORY IMAGE FILE (.EXE) 


The .EXE memory image file is created by the linker. This file contains 
the memory images of your executable system. Memory images 
include assembled and resolved opcodes and initialized data buffers. 
The memory image file is used to load executable code into the 
simulator, emulator and PROM splitter. 


The first three characters of this file are <ESC> <ESC> i. These 
characters tell the emulator that the succeeding code is upload 
information for program, data, and boot memory (if used). <ESC> 
sequences are ignored by the simulator and the PROM splitter. 


Each kernel of information which can be loaded into a particular 
region of memory is indicated by one of the following: @PA, @PO, 
@DA, @DO, @BO. The P indicates program memory; D indicates data 
memory; B indicates boot memory; O indicates ROM; A indicates 
RAM. 


Following the @XX header is a four-character hexadecimal start 
address for the upload, and then the sequence of words to be loaded. 
These words contain six hex characters for PM and BM, and four 
characters for DM. 


Each kernel is terminated by a #nnnnnn... line. Kernels can be in any 
order. The file ends with <ESC> <ESC> 0 to tell the emulator that the 
upload is complete. An example .EXE file is shown below: 


<ESC> <ESCS1 
@PO 

0004 

1CO0O7F 

1CO5BF 

OAOQOOF 

le ae Ba I 
@DA 

0000 

2D40 

0000 
FIZ3 I 23123123 
@BO 

0000 

O3242A 

025B26 

01921C 
FilAzclzcslAadgLad 
@PO 

6000 

7FFFFF 

7FFD88 

80009E 
#123123123123 
@BO 

0800 

OAQOOF 

FD887F 

025B26 
FI23IZ31235123 
@DA 

0182 

0040 
#123123123123 
@DA 

0183 

0000 
TiZ2ItAsLzS Le 
<ESC> <BSC>o 


Notice that the boot memory words in this file are only 24 bits wide, 
instead of 32 bits wide as in boot memory EPROM devices. The 32-bit 
boot memory words are generated by the PROM splitter. Boot memory 
addresses in the .EXE file are word addresses (similar to program 
memory addresses), rather than PROM byte addresses. 


The linker treats boot memory as an array of 24-bit program memory 
words divided into 8 pages. The page number is embedded in the @BO 
address. To obtain the page number of any address, divide it by 2048 
and drop the remainder (for 2K-size pages). 


B.3 SYMBOL TABLE FILE (.SYM) 


The .SYM symbol table file is created by the linker to allow symbolic 
debugging. It lists all symbols encountered by the linker and their 
associated addresses. A separate list is generated for each module 
indicating which symbols can be referenced within the scope of the 
module. 


The first three characters of this file are <ESC> <ESC> d. <ESC> 
sequences are ignored by the simulator. These characters tell the 
emulator that the succeeding code is the debug symbol information. 
<ESC> sequences are ignored by the simulator. 


The _m directive names a source code module and gives its base 
address. This directive takes the form 


_mmodulename addr 


where addr is the hexadecimal base address. A p, d, or b# is appended 
to indicate placement in program, data, or boot memory. The boot 
page number is specified by b#. 


Each line following the _mmodulename directive names a symbol which 
can be referenced within the context of the module. The symbol’s 
address and memory origin (p, d, or b#) are also given. A ZZZZ in the 
address field indicates that the address for that symbol was never 
resolved (not all symbols have memory addresses associated with 
them). 


The file is closed by <ESC> <ESC> 0 to tell the emulator that the file 
transmission is complete. 


File Formats B 


The following is an example of a symbol table file for a single module 
in program memory: 


<ESC> <ESC>d 

_mMFFT 0004p 

REAL _OUTPUT 1000d 
IMAGINARY_OUTPUT 2000d 
MAGN 0100d 

SIN_COEF 6000p 


COS_COEF 6080p 
FFT_START 0020p 
BUTTERFLY_LOOP 0033p 
GROUP_LOOP 0037p 
STAGE LOOP 0040p 
<ESC> <ESC>o 


The following example shows the .SYM file for the sample ADSP-2101 
program shown at the end of Chapter 3. This program consists of two 
modules located on boot page 0: 


<ESC> <ESC>d 
_mFIR_ROUTINE OOOFbO 
FIR_START QOOOFbO 
CONVOLUTION 0014b0 
COEFFICIENT 0O000b0 
DATA BUFFER 3800d 
_mMAIN_ROUTINE 0019b0 
DATA BUFFER 3800d 
COEFFICIENT 0000b0 
RESTARTER 0035b0 
CLEAR_BUFFER 003Db0 
WAIT 0052b0 

FIR_START OOOFbDO 
<ESC> <ESC>0 


B.4  PROMIMAGE FILES (.BNU, .BNM, .BNL) 


PROM image files are generated by the PROM splitter. The files are 
used with an industry-standard PROM burner to program memory 
devices for your hardware system. One file is needed for each memory 
chip to be programmed. The file format depends on which switch 
options you choose when invoking the PROM splitter. See Chapter 5. 


Three types of image files are generated by the PROM splitter: .BNU for 
the upper bytes of 24-bit words, .BNM for the middle bytes, and .BNL 
for the lower bytes. 


The files can be generated in either Intel Hex format or Motorola S 
format. 


B.4.1 HIP Boot Files (.HIP) 

The HIP splitter utility program generates program files which may be 
booted via the host interface port of the ADSP-2111 or ADSP-21msp50. 
These files are similar in format to a .BNM file produced by the PROM 
splitter for program or boot memory—the first byte of the file, which is 
booted into the processor’s HDR3 register, contains the page length (see 
file format descriptions below). These files are generated in Motorola S 
Record format and are given the filename extension .HIP. 


B.4.2 Intel Format 


The examples below show the Intel format for a .BNM program memory 
file, a byte stream program memory file, and a boot page memory file. 
Each line of the file is a data record with the exception of the last line, 
which is the end of file record. Larger files contain additional data 
records. | 


Program Memory .BNM File 


:0A0004003C40343434261422260850 data record 
:00000401FB end of file record 


This file format is obtained by using the -pm and -i switches. The file 
contains the middle bytes of 24-bit program memory words. The data 
records are organized into the following fields: 


:0A0004003C40343434261422260850 


E PRU bebeeeseweea seneee ota. senses start character 
DR, £4 Getawingecedaesaedeaceeasys byte coun: of this record 
OUT! sasetawseedandaeeesssamede address of first data byte 
OD auseeneng pee ea ateu bags record type 
Pe aeaneee wee ed edseneeees first data byte 
08 .... last data byte 
50 .. checksum: twos complement 
negation of binary summation 
(least significant 8 bits) of 
preceding bytes, including byte 
count, address and data bytes 


:00000401FB 


SY Baesuneed vewasen eg emedeeaes unre start character 
OO des dau cbs remedy es eee yeas es byte count (zero for this record) 
(ps eMamosevatenakeeeexhake address of first byte 
Wl eeeee sedeeens aeenaasnnas record type 
BW a5 055940 tevnatqwed duces checksum 


Program Memory .BNM Byte Stream File 


: 1E0000003C005540008034000034001434000826180F1400C222E00F26300208000F36 


:0Q001FO1E0 


record 
This file format is obtained by using the -pm and -ui switches; the file 

contains all three bytes of program memory words. The fields are the 

same. Note that every third data byte (shown in bold) corresponds to 

the previous example file. 


Boot Memory .BNM File (2K boot pages) 


>200000001111000A0N00100FFOOLIOOFFOLIILOOFFII1IIOOFFIOOOOOFFILOOOOFFI11000FF33 
>20002000000000FFOOOQOLOOFFIIOQOOFFII1OOOFFOOOLOOFFOOI1IOOFFO11100FF3CO0E5FF50 
:200040000D0388FF680080FFE89800FFI4014EFFEIO000FF20400FFFO50000FFODOCICFF33 
:200060000A001FFF1I8035FFFOQQ0000FFOQOQOQO00FFOOQQ000FFOA001FFFOOQ0Q000FFOOQO0000FFBC 
:20008000000000FFOAD0OLFFFOOQQOO0Q0FFOOQOOQQOOFFOQQOOOFFI800FFFFOOQQ000FFOOQO000FF28 
:2000A000000000FFOAQD0LFFFOQOQQOO0Q0FFOOQQO00FFOQOQOOQQ00FFOADOLFFFOOQOOOFFOOOQOOFFF6 
:2000COQ0000000FFOADOLFFFOOQQOOFFOQOQOOFFOQOQOOQOFF3400F8FF3800F8FF340014FF5B 
:2000EQ000380014FF378000FF380000FF3COOF5FF1403DEFFAQQ0000FF37FEFIFFAQ0004FF3D 
:20010000A00004FFA00004FFA0N0004FFA00004FFA0N0BF4FFA0003 4FFA69274FFA00004FF94 
>:20012000A00004FFA00004FFA00004FFA0N0004FFA0D0004FFA00004FFA70004FFALOOO4FFIF 
:2000A0003COO04FF3CO183FFO28000FF18052FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFE5 
:O0Q000001FF 


This file format is obtained by using the -bm and -i switches. The file 
contains four-byte boot memory words on 2K-word pages. The records 
have the same fields as described above with the following additions: 


e Every fourth data byte is a pad byte (FF) inserted to produce the 32-bit 
word width. 


e The pad byte of the first data word (0A), at PROM byte address 
0x0003, is the page length for this boot page. 


e Pad bytes are added to the last data record to make the number of 
words on the page a multiple of 8. 


data record 
end of file 


data record 
data record 
data record 
data record 
data record 
data record 
data record 
data record 
data record 
data record 
data record 
end of file 


B.4.3 Motorola S Format 


Motorola S Record format is similar to the Intel standard. The example 
below shows an S Record .BNM file containing the middle bytes of 
program memory words. Each line of the file is a data record with the 
exception of the last line, which is the end of file record. Larger files 
contain additional data records. 


Program Memory .BNM File 


$10D00043C4034343426142226084c If data record 
S903000DEF end of file record 


This file format is obtained by using the -pm and -s switches. The 
records are organized into the following fields: 


$10D00043C4034343426142226084C 


Bl pe ncnatapaaper ears obeyedneagey start character 
OD nd cas cbuseanndesessecaveeuss byte count of this record 
OOO 26 week aces ceeen sedan yeas address of the first data byte 
S- Gehee shan ones eeewrega first data byte 
08 .... last data oyte 
4c .. checksum: ones complement of 
binary summation (least 
significant 8 bits) of preceding 
bytes, including byte count, 


address and data bytes 
S903000DEF 
Sg start character 
03 byte count of this record 
000D address of the first byte 
EF checksum 


The Motorola format may also be used to create a byte stream file 
containing all three bytes of program memory—+his is the S2 format. 
See Chapter 5, PROM Splitter, for the complete set of options. 


Error Messages 


C.1 INTRODUCTION 


This appendix lists and provides a definition of all error messages 
generated by the ADSP-21xx assembler software. 


C.2 SYSTEM BUILDER ERRORS 


The system builder generates messages for syntax errors and system 
architecture definition errors. Syntax errors are errors in usage of the 
system builder directives in the input file. Architecture definition errors 
are primarily errors in memory configuration, and may be either fatal or 
non-fatal. Error sources must be corrected in the input file. 


Boot memory segment out of range of address space 
Upper limit of boot memory addressing is 16K. 


BOOT page exceeds max boot page size 
Boot page segment declared with length greater that 2048. 


BOOT page must be on a 2K word boundary 
Boot page segments do not accept the ABS modifier; the first address 
of a boot page is always equal to the boot page number +2048. 


Code/data- 24 required bits in memory width 
Info only: 24-bit word width in PM. 


Data Memory from 0x3a00 to Ox3bff is not valid in ADSP2105 parts 
Non-existent memory in ADSP-2105 systems. 


Data memory segment exceeds 16K boundary 
Memory boundary limit exceeded. 


Data memory segment out of range of address space 
Upper limit of data memory addressing is 16K. 


Divide by zero in expression 
Arithmetic error. 


DM segment can have DATA attribute only 


Segment declared in data memory may not have the CODE qualifier. 


DM segment cannot exceed physical address h#3fff 
Segment declared in data memory address beyond Ox3FFF. 


Expecting a constant at symbol symbol 
Numeric constant required in place of the named symbol. 


Expecting 'ABS' at symbol symbol 
Keyword 'ABS' required in place of the named symbol. 


Expecting an identifier at symbol symbol 
User-defined identifier required in place of the named symbol. 


Expecting directive at symbol symbol 
System builder directive required in place of the named symbol. 


Expecting segment modifier at symbo.. symbol 
Segment qualifier required in place of the named symbol. 


Expecting 'SYSTEM' at symbol symbol 
'SYSTEM' must be the first text read by the System Builder. 


Expecting '.' at symbol symbol 
'." required in place of the named symbol. 


Expecting ']' at symbol symbol 
' |' required in place of the named symbol. 


Expecting '=' at symbol symbol 
'=' required in place of the named symbol. 


Expecting '/' at symbol symbol 
' /' required in place of the named symbol. 


Expecting ';' at symbol symbol 
';' required in place of the named symbol. 


FATAL ERROR: Boundary error occurred 
Memory boundary limit exceeded. 


FATAL ERROR: Impossible PM configuration 
Program memory configuration not allowed. 


FATAL ERROR: Overlap occurred 
Two or more declared segments overlap. 


FATAL ERROR: Unable to openfilename for reading 
System Builder cannot find .SYS file or cannot create .ACH file; 1) the 
path/filename specified is incorrect or not allowed, 2) file does not 
exist, or 3) operating system condition. 


FATAL ERROR: Used invalid memory on ADSP2105 part 
Non-existent portion of PM or DM declared. 


Internal Program Memory from 0x400 to Ox7FF is not valid in ADSP2105 parts 
Non-existent memory in ADSP-2105 systems with MMAP=0. 


Invalid memory type 'BOOT' 
No boot memory in ADSP-2100 systems. 


No DM memory at addresses 0x3a00-Ox3bfE£ 
Non-existent memory in ADSP-2105 systems. 


NOTICE: ? no PM found 
No program memory segment was declared. 


Ports are not allowed in boot memory 
I/O ports may only be placed in data or program memory. 


Problem mallocing enough memory 
Not enough memory is available on host computer for System 
Builder to continue running. 


Program Memory out of range of 2105 address space 0 - Ox3bff 
Upper limit of memory in ADSP-2105 systems with MMAP=1. 


Program memory segment out of range of address space 
Upper limit of program memory addressing is 16K. 


Program memory segment out of range of address space for ADSP2100 
Upper limit of program memory addressing is 32K for ADSP-2100 systems. 


Trying to redeclare symbol symbol 
The named symbol is declared twice in the input file. 


Warning: Absolute address specified for boot page will 
be ignored. Segment address will be boot page * 2K. 
Boot page segments do not accept the ABS modifier; the first address 
of a boot page is always equal to the boot page number +2048. 


Warning: Missing semicolon after ENDSYS directive 
A semicolon must always terminate an instruction or directive. 


You must specify memory segment address 
ABS qualifier was omitted in a segment declaration. 


You must specify memory segment area 
PM, DM, or BOOT qualifier was omitted in a segment declaration. 


You must specify memory segment type 
ROM or RAM qualifier was omitted in a segment declaration. 


C.3 ASSEMBLER ERRORS 


ADI_DSP environment variable not set up 
ADIL_DSP gives path to installed software; verify proper installation 
and check PATH statement. 


ASMPP could not activate \ASMPP.EXE. Execution terminated 
Standard preprocessor cannot run; verify proper software installation 
and check PATH statement. 


Boot page out of range 
Page number specified is invalid. 


Divide by zero in expression 
Arithmetic error. 


Do labels cannot be external 
DO loop cannot reference an external label. 


Do loop terminates do loop at symbol symbol 
A DO instruction may not be the last instruction of a DO loop. 
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Dreg of data memory access must be one of: AX0O, AX1, MX0O, MX1 
Incorrect data register used in instruction. 


Dreg of program memory access must be one of: AYO, AY1, MYO, MY1 
Incorrect data register used in instruction. 


. ENDMACRO must be preceded by macro definition 
Code preceding .ENDMACRO statement does not form a proper 
macro definition. 


Expecting a condition at symbol symbol 
Instruction condition code required in place of the named symbol. 


Expecting a constant at symbol symbol 
Numeric constant required in place of the named symbol. 


Expecting a data format at symbol symbol 
'UU', 'SU', 'US', or 'SS' required in place of the named symbol (in 
an instruction). 


Expecting a filename at symbol symbol 
An assembler or C preprocessor directive which requires a 
filename is given without one (e.g. #include, INCLUDE, .INIT). 


Expecting a macro argument at symbol symbol 
Incorrect number or form of arguments/parameters given in a 
macro definition or invocation. 


Expecting a place holder at symbol symbol 
%n placeholders (arguments) must be used in a macro definition. 


Expecting an identifier at symbol symbol 
User-defined identifier required in place of the named symbol. 


Expecting an index register at symbol symbol 
Index register required in place of the named symbol (in an 
instruction). 


Expecting an integer at symbol symbol 
Immediate integer operand required in place of the named symbol 
(in an instruction). 
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Expecting AR as the destination of the alu operation 
AR required in instruction. 


Expecting 'AV', 'AC', 'MV' or 'CE' at symbol symbol 
Instruction condition code required in place of the named symbol. 


Expecting 'AX0', 'AX1', 'MX0O', or 'MX1' for DM read 
'AX0', 'AX1', 'MX0', or 'MX1' required in instruction. 


Expecting 'AYO', 'AY1', 'MYO', or 'My1' for PM read 
'AYO', 'AY1', 'MYO', or 'MY1' required in instruction. 


Expecting binary operator at symbol symbol 
Logical (not bitwise) expression operator required in place of the 
named symbol. 


Expecting 'C' at symbol symbol 
'C' (carry bit) required in place of the named symbol (in an 
instruction). 


Expecting 'DM' at symbol symbol 
'DM' required in place of the named symbol (in an instruction); 
immediate addresses must be in data memory. 


Expecting 'ENA' or 'DIS' at symbol symbol 
'ENA' or 'DIS' required in place of the named symbol (in an 
instruction). 


Expecting .ENDMACRO at symbol symbol 


A macro definition is not properly terminated with the 
-ENDMACRO directive. 


Expecting 'EXP' at symbol symbol 
'EXP' required in place of the named symbol (in an instruction). 


Expecting 'EXPADJ' at symbol symbol 
'EXPADJ' required in place of the named symbol (in an 


instruction). 

Expecting 'HI', 'LO', or 'HIX' at symbol symbol 
'HI', 'LO', or 'HIX' required in place of the named symbol (in an 
instruction). 


Expecting 'HI' or 'LO' at symbol symbol 
‘HI’ or 'LO' required in place of the named symbol (in an instruction). 


Expecting 'I0', ‘'I1', 'I2', or 'I3' for DM index register 
10", ‘Il’, '12', or 'I3' required in instruction. 


Expecting 'I0', ‘'I1', 'I2', or 'I3' at symbol symbol 
10", '[1', '[2', or 'I3' required in place of the named symbol (in an 
instruction). 

Expecting "I4', "IS", '"i6', or 'I7' at symbol symbol 
'14', 'I5', 'I6', or 'I7' required in place of the named symbol (in an 
instruction). 

Expecting 'MO', 'Ml', 'M2', or 'M3' at symbol symbol 


MO-M3 must be used if IO-I3 are used (in an instruction). 


Expecting 'M4', 'M5', '‘M6', or 'M7' at symbol symbol 
'M4', 'M5', 'M6', or 'M7' required in place of the named symbol (in an 
instruction). 


Expecting MODULE directive at symbol symbol 
The .MODULE directive must be the first statement in any file which 
the assembler reads. 


Expecting MODULE qualifier at symbol symbol 
MODULE qualifier required in place of the named symbol. 


Expecting MR as the destination of the mac operation 
MR required in instruction. 


Expecting 'MR' at symbol symbol 
'MR' required in place of the named symbol (in an instruction). 


Expecting 'OR' at symbol symbol 
'OR' required in place of the named symbol (in an instruction). 


Expecting 'PM' at symbol symbol 
'PM' required in place of the named symbol (in an instruction). 


Expecting 'PUSH' or 'POP' at symbol symbol 
'PUSH' or 'POP' required in place of the named symbol (in an 
instruction). 
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Expecting 'RND' at symbol symbol 
'RND' required in place of the named symbol (in an instruction). 


Expecting segment name at symbol 
Segment name required in place of the named symbol (in an 
instruction). 


Expecting shift operand at symbol symbol 
Shift operand required in place of the named symbol (in an 
instruction). 


Expecting 'STS' at symbol symbol 
'STS' required in place of the named symbol (in an instruction). 


Expecting VAR qualifier at symbol symbol 
VAR qualifier required in place of the named symbol. 


Expecting '1' at symbol symbol 
'l' required in place of the named symbol (in an instruction). 


Expecting '0' at symbol symbol 
'0' required in place of the named symbol (in an instruction). 


Expecting '0' or '1' at symbol symbol 
'0' or 'l' required in place of the named symbol (in an instruction). 


Expecting ']' at symbol symbol 
']' required in place of the named symbol. 


Expecting '-' at symbol symbol 
'-' (Subtract) required in place of the named symbol (in an 
instruction). 


Expecting '*' at symbol symbol 
'*' (multiply) required in place of the named symbol (in an 
instruction). 


Expecting '(' at symbol symbol 
‘(required in place of the named symbol (in an instruction). 


Expecting ',' at symbol symbol 
', required in place of the named symbol (in an instruction). 


Expecting '=' at symbol symbol 
'=' required in place of the named symbol (in an instruction). 


Expecting ')' at symbol symbol 
')' required in place of the named symbol (in an instruction). 


Expecting ':' at symbol symbol 
':' required in place of the named symbol (in an instruction). 


Expecting ';' at symbol symbol 
';, required in place of the named symbol (in an instruction). 


Failed to open '#include' file filename 
File to be included by C preprocessor was not found; 1) the 
path/ filename given was incorrect, or 2) file does not exist. 


FATAL: Unable to execute 'ASM2' 
Core assembler cannot run; verify proper software installation and 
check PATH statement. 


FATAL: unable to execute 'ASMPP' 
Standard preprocessor cannot run; verify proper software 
installation and check PATH statement. 


FATAL ERROR: Ran out of memory 
Assembler cannot process current file in available memory. 
Reduce file size or increase amount of memory available on PC. 


FATAL ERROR: unable to open filename for reading 
Assembler cannot find the named input file; 1) the path/filename 
specified is incorrect, or 2) file does not exist. 


FATAL ERROR: unable to open filename for writing 
Assembler cannot create the named file due to an operating 
system condition, such as a bad filename or full disk. 


Illegal address operand symbol 
Immediate operand required in place of the named symbol (in an 
instruction). 


Illegal address specified 
Address is in un-declared memory or is invalid. 


Illegal data specified 
Data is invalid. 


ITllegal do until term at symbol symbol 
DO UNTIL instruction has an illegal termination condition. 


Illegal do until not term at symbol symbol 
DO UNTIL NOT instruction has an illegal termination condition. 


Illegal exponent symbol 
Exponent is out of range (in an immediate shift instruction). 


Illegal INIT value symbol 
Buffer initialization value is invalid. 


Tllegal length specified 
Buffer length is invalid. 


Illegal length operator usage 
'%' (length of) operator incorrectly used. 


Illegal lhs 'item' 
Item named is invalid when located to the left of equal sign (in an 
instruction). 


Illegal mode operand symbol 
Mode operand required in place of the named symbol (in an 
instruction). 


Illegal multi-function 
Incorrect instruction syntax used (illegal operands included). 


Illegal offset specified 
Buffer address offset is invalid. 


Illegal operand symbol 
Instruction operand required in place of the named symbol. 


Illegal rhs ‘item' 


Item named is invalid when located to the right of equal sign (in 
an instruction). 
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Illegal stack operand symbol 
Stack operand required in place of the named symbol (in an 
instruction). 


Tllegal yop symbol 
Instruction yop required in place of the named symbol. 


Tllegal xop symbol 
Instruction xop required in place of the named symbol. 


INCLUDE must be preceded by '.' 
Assembler directives must start with a period (C preprocessor 
include directive is #include). 


.LOCAL valid only in macro definitions 
.LOCAL statement detected within code which does not form a 
proper macro definition. 


MACRO must be preceded by '.' 
Assembler directives must start with a period. 


Multiple do's to the same address symbol 
Illegal do loop. 


Must use DAGO for data memory access 
Incorrect data address generator used in instruction. 


Not enough arguments to macro 
The number of parameters passed in a macro invocation must 
match the number of arguments declared. 


Place holder out of range at symbol symbol 
The %n placeholders (arguments) in a macro definition must be in 
consecutive numerical order: %1, %2, %3, etc. 


Preprocessor failed to open \filename 
Input filename was not found; 1) the path/filename given was 
incorrect, or 2) file does not exist. 


Problem mallocing enough memory 
Memory allocation limit or restriction reached. 
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Result register contention 
Two or more instructions executed in the same cycle use the same 
result register. 


Too many arguments to macro 
The number of parameters passed in a macro invocation must 
match the number of arguments declared. 


Trying to redeclare symbol as a buffer 
Named symbol is declared twice. 


Trying to redeclare symbol as an external 
Named symbol is declared twice. 


Trying to redeclare symbol as a label 
Named symbol is declared twice. 


Trying to redeclare symbol as a port 
Named symbol is declared twice. 


Trying to redefine symbol 
The named symbol has already been defiried within the current 
module. 


Unable to open filename for reading 
Filename given with .INCLUDE directive was not found; 1) the 
path/ filename given was incorrect, or 2) file does not exist. 


Undefined do addr: address 
Address specified in non-existent memory. 


Undefined symbol: symbol 
Named symbol is not declared properly. 


Warning: Illegal base address for circular buffer 
Circular data buffers may only start at particular addresses in 
memory. Refer to the sections “More On Circular Buffers” and 
“Special Case: Circular Buffer Lengths of 2” in Chapter 3 of this 
manual. 


Warning: Illegal register access inferred 
Incorrect register usage. 


C.4 LINKER ERRORS 


The linker generates error messages, warning messages, and 
informational messages. Some errors allow the linker to continue 
running in order to detect additional problems, but fatal errors halt the 
linking process. Both error types are reported to the display, as well as 
a limited number of warning and informational messages. Error 
sources must be corrected. 


Several categories of linker errors are detected. The most common 
messages point out memory allocation and symbol reference problems. 
These errors can result from insufficient memory declarations, 
improper absolute address specifications, undefined symbol 
references, etc. 


Assembler detected errors in module modulename 
(Operating System Error) 
Assembly errors are flagged in the specified module; source code 
must be corrected and re-assembled. 


-c switch must be used with -lib switch 
The -lib switch links the ADSP-2100 Family Runtime Library of C 
functions, requiring the use of the linker’s -c switch (for compiled 
C programs). 


Calling broken software 
(Software Error) 
Software failure detected in linker or assembler. 


Can't create executable file filename 
(Operating System Error) 
Linker cannot create .EXE file due to an operating system 
condition, such as a bad filename or full disk. 


Can't create list file filename 
(Operating System Error) 
Linker cannot create .MAP file due to an operating system 
condition, such as a bad filename or full disk. 


Can't create symbol file filename 
(Operating System Error) 
Linker cannot create SYM file due to an operating system 
condition, such as a bad filename or full disk. 
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Can't create temporary name 
(Operating System Error) 
Linker is unable to complete the directory search. When searching 
a directory for files to link, the linker must create a temporary file 
containing a list of the directory’s contents; this error is seen when 
insufficient memory is available for the file on the host computer 
or if the list is not found. 


Can't find symbol of module modulename in symbol table 
(Software Error) 
Linker has allocated memory for a symbol (buffer, module, or 
address label) without error, and added symbol to the symbol 
table; when the linker subsequently tries to assign an address, 
however, the symbol is not present in the symbol table (linker 
failure). 


Can't open architecture file filename 
(Operating System Error) 
Linker can’t find .ACH file; 1) default filename not found, and no 
alternative specified with the -a switch, 2) the path/filename 
specified with -a switch is incorrect, or 3) file does not exist. 


Can't open buffer init file filename 
(Operating System Error) 
Linker cannot find buffer initialization file; 1) the path/ filename 
specified (in .INIT assembler directive) is incorrect, or 2) file does 
not exist. 


Can't open code file filename 
(Operating System Error) 
Linker cannot find the named .OBJ file to link; 1) the path/ 
filename specified is incorrect, or 2) file does not exist. 


Can't open file filename 
The linker cannot locate the assembler-output .CDE file named; 1) 
the path/ filename given was incorrect, or 2) file does not exist. 


Can't open input list file filename 
(Operating System Error) 
File named with -i switch is not found; 1) the path/ filename 
specified is incorrect, or 2) file does not exist. 
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Can't open library file filename 
(Operating System Error) 
Linker cannot find the named .OB] file to link; 1) the search 
path/directories specified (with ADIL environment variable or 
-dir switch) are incorrect, or 2) file does not exist. 


Can't open library object file filename 
The linker cannot locate the named routine of the ADSP-2100 
Family Runtime C Library: verify proper software installation. 


Can't open temp file filename 
(Operating System Error) 
Linker cannot find temporary file it created during directory 
search. 


Can't place symbol of module modulename 
(Memory Allocation Error) 
The data buffer or code module named by symbol cannot be placed 
in 
memory. 


/ at address address 
Object is declared at absolute address specified (with ABS 
qualifier), but cannot be placed there. 


/ contention at address 
Two objects have been declared at the same absolute address or 
overlap each other at the specified address. 


/ for boot page page# 
Object is to be placed in boot memory on page number listed. 


/ no appropriate pm,dm ram available 
Object to be placed is declared in PM RAM or DM RAM; this 
memory type does not exist in architecture. 


/ no appropriate pm,dm rom available 
Object to be placed is declared in PM ROM or DM ROM; this 
memory type does not exist in architecture. 


/ not enough pm,dm rom,ram left 
Not enough of the specified memory type is available to complete 
placement of object. 
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/ (Warning) placement forced to be external 
Object declared in internal DM or PM; linker is placing object in 
external DM or PM, however, due to shortage of on-chip memory 
space (WARNING ONLY). 


/ requires # words of pm,dm rom, ram 
Relocatable object has length (in words) shown, and is declared in 
memory type specified (INFORMATION ONLY). 


/ requires # words of pm,dm rom,ram from a segment named segname 
Object is relocatable within named segment, has length (in words) shown, and is 
declared in memory type specified (INFORMATION ONLY). 


/ symbol of module modulename 
Symbol specifies the data buffer or code module being placed 
(INFORMATION ONLY). 


.....check for conformity with arch. description 
systemname (filename) 
The system architecture file specified for the linker is inconsistent with 
the memory configuration required by the modules being linked. 


Circular buffer buffername has bad absolute address 
OxOXXX 
Circular data buffers may only start at particular addresses in 
memory. Refer to the sections “More On Circular Buffers” and 
“Special Case: Circular Buffer Lengths of 2"” in Chapter 3 of this 
manual. 


Construct too large from filename- examine source 
A .INIT directive in the named input file contains too many data 
values. 


Declaration of symbol in module modulenamel is 
inconsistent with its use in modulename2 
A symbol can name various objects: a module, data variable/buffer, 
program label, memory-mapped port, macro, or constant. The named 
symbol is used in different ways in the two modules indicated. 


Errno: # Can't execute MSDOS command: command 
(Operating System Error) 
Linker has given a DOS command which is not correctly executed; 
DOS error number listed is returned to linker. 


Fail on fseek: filename 
(Operating System Error) 
Linker is unable to complete a file or directory search. 


Failed request to alloc more memory 
(Operating System Error) 
Not enough memory is available on host computer for linker to 
continue running. 


filename too big- breakup sources 
The name .OBJ file is too large for linker to process. 


Global buffername declared in modules modulenamel and 
modulename2 (maybe others) 
(Symbol Reference Error) 
A global buffer should only be declared in one module to prevent 
conflicting usage. 


Module name modulename duplicated 
(Symbol Reference Error) 
Two or more modules to be linked have the same name; a unique 
name must be given to each. 


New module search fail 
(Software Error) 
A module name is not found in symbol table (linker failure). 


Offset on symbol in module modulename forces address out 
of range 
The variable/buffer or program label named is used with an offset 
(symbol + offset) which generates an out-of-range address. 


Opcode with bad unresolved field 
(Software Error) 
Opcode generation mechanism of the assembler is not operating 
correctly (assembler failure). 


Sources too large filename 
The name .OBJ file is too large for linker to process. 


Symbol made global twice in modulename 
The named symbol is declared as GLOBAL in two different modules. 
The module named is the second occurrence. 


Symbol of module modulename not linked 
(Symbol Reference Error) 
The data buffer or address label listed is declared as EXTERNAL 
in this module, but is not declared as .GLOBAL or .ENTRY in 
another module. 


Symbol of modulename is bootable but ref’d as iff not 
(Symbol Reference Error) 
The buffer or module named is stored in boot memory; a non- 
bootable program has referenced or called the bootable object, 
which may not have been booted yet. 


Symbol of modulename is not part of boot page page# 
(Symbol Reference Error) 
The buffer or subroutine (module) named is referenced on the 
boot page specified, but a copy is not located on the page. 


Symbol of modulenamel ref'd in modulename2 is not part 
of boot page page# 
(Symbol Reference Error) 
The global buffer or address label named by symbol is referenced 
(in the second module named) on the boot page specified, but a 
copy is not located on the page. 


Too many files specified in filename- max = n 
The indirect file used with the linker’s -i switch names too many 
files for the linker to process. 


Too many files to link— max = n 
Too many input files are listed on the linker invocation line. 


Unable to create temporary files 
This message may indicate that the linker has run out of space on 
your hard disk—you should attempt to increase the amount of 
memory available on the disk. 


Unable to open user library file filename 
The linker cannot locate your library file; 1) the file’s path cannot 
be determined, or 2) file does not exist. 


Unable to open standard library file filename 
The linker cannot locate the named routine of the ADSP-2100 
Family Runtime C Library: verify proper software installation. 


Usage of symbol in module modulename implies it is in 
pm,dm, it 1s not 
(Symbol Reference Error) 
The object named is declared in PM or DM; it is referenced in the 
code module named as if to be found in the other memory space. 


Usage of symbol in module modulename is inconsistant 
with declaration 
(Symbol Reference Error) 
The buffer name or address label shown is misused in code; for 
example, using a variable name as an entry point. 


(Warning) Boot memory images for boot page page# 
larger than declared boot memory in arch. description 
The total amount of code and data designated for storage on the 
specified boot page exceeds the size of the system builder- 

declared boot page segment. 


(Warning) Bootable image of n K bytes larger than 
boot memory n K bytes— check arch. description 
systemname (filename) 
The total amount of code and data designated for storage in boot 
memory exceeds the declared size of boot memory. 


(Warning) Bootable module modulename placed 
externally at PM[OxXXXX]— it will not be booted 
The total amount of boot memory declared has been allocated by 
the linker—the named module will be placed in external program 
memory. 


(Warning) Initialization data for buffername in 

module modulename is longer than buffer 
Initialization file contains more data than can be loaded into 
buffer (WARNING ONLY). 


C-19 


(Warning) No boot memory for bootable images— check 
arch. description systemname (fileriame) 
Some (or all) of the modules being linked are designated for 
storage in boot memory, but the system architecture file specified 
for the linker does not have any BM declared. 


(Warning) No path to module modulename 
The linker cannot locate the named module in any of the input 
files—check the path/filenames given. 


C.5 PROM SPLITTER ERRORS 

Mixed memory types 
The PROM splitter may only be invoked with one memory type 
switch: -dm, -pm, or -bm. 


Illegal boot memory size 
The amount of code and data designated for boot memory exceeds 
the total available. 


Can't open file 
The PROM splitter cannot locate the .EXE file named as input; 
1) the path/ filename given was incorrect, or 2) file does not exist. 


Can't open memory image file 
The PROM splitter cannot locate the .EXE file named as input; 
1) the path/filename given was incorrect, or 2) file does not exist. 


Boot code is larger than Boot page 
The amount of code and data designated for a specific boot page 
exceeds its storage capacity. 


Loader image does not fit in 8 boot pages 
The program contained in the input file is too large for the loader 
option (-loader switch). 


Loader BM and specified BM overlap 
An object specified for storage in boot memory is located at an 
address needed by the program generated with the -loader option. 


Interrupt Vector Addresses 


D.1 VECTOR TABLES 


The interrupt controller of ADSP-21xx processors allows the 
processors to respond to various interrupts. Depending on the 
configuration of SPORT1 (for all processors except the ADSP-2100), 
there may be one or more interrupts generated by external devices. 
Additional interrupts can be generated internally by serial ports, timer, 
host interface port, and analog/digital converters, depending on 
which processor is being used. 


The processor responds to interrupts by shifting control to the 
instruction located at the appropriate interrupt vector address. The 
tables below show the interrupt vector addresses and program startup 
address for each processor. 


Interrupt Source Interrupt Vector 
IROQO 0x0000 
IRQ1 0x0001 
IRQ2 0x0002 
IRO3 0x0003 
program startup at RESET 0x0004 


ADSP-2100 Interrupts & Interrupt Vector Addresses 


Interrupt Source Interrupt Vector 
program startup at RESET 0x0000 

IRQ2 0x0004 (highest priority) 
SPORTO Transmit 0x0008 

SPORTO Receive 0x000C 

SPORT1 Transmit / IRQ1 0x0010 

SPORT1 Receive / IRQO 0x0014 

Timer 0x0018 (lowest priority) 


ADSP-2101 Interrupts & Interrupt Vector Addresses 


\ddresses 


Interrupt Source Interrupt Vector 
program startup at RESET 0x0000 

IRQ2 0x0004 (highest priority) 
SPORT1 Transmit / IRQ1 0x0010 

SPORT1 Receive / IRQO 0x0014 

Timer 0x0018 (lowest priority) 


ADSP-2105 Interrupts & Interrupt Vector Addresses 


Interrupt Source Interrupt Vector 
program startup at RESET 0x0000 

IRQ2 0x0004 (highest priority) 
HIP Write from Host Ox0008 

HIP Read to Host Ox000C 

SPORTO Transmit 0x0010 

SPORTO Receive Ox0014 

SPORT1 Transmit / IRQ1 0x0018 

SPORT1 Receive / IRQO 0x001C 

Timer 0x0020 (lowest priority) 


ADSP-2111 Interrupts & Interrupt Vector Addresses 


Interrupt Source Interrupt Vector 
program startup at RESET 0x0000 

IRQ2 0x0004 (highest priority) 
HIP Write from Host Ox0008 

HIP Read to Host Ox000C 

SPORTO Transmit Ox0010 

SPORTO Receive Ox0014 

DAC Transmit 0x0018 

ADC Receive OxC0!01C 

SPORT1 Transmit / IRQ1 0xC020 

SPORT1 Receive / IRQO OxC1024 

Timer Ox0028 (lowest priority) 
Powerdown Ox002C 


ADSP-21msp50 Interrupts & Interrupt Vector Addresses 


simulator Error Messages 


ay INTRODUCTION 


This appendix lists and provides definitions of all error messages 
generated by the ADSP-2100 Family Simulator. 


Address supplied is invalid or symbol doesn't exist 
The address is not valid for the specified memory space or the symbol is 
not defined. 


Architecture does not define this address as a port 
The address is not defined as a port in the architecture file. 


Attempt to read from a port with no read access 
The program attempted to read from a port that is not designated as an 
input port. This condition results from a programming error or from a 
failure to properly set up the port. 


Attempt to read from non-existent memory 
The memory location is not defined in the architecture file. 


Attempt to write to a port with no write access 
The program attempted to write to a port that is not designated as an 
output port. This condition results from a programming error or from a 
failure to properly set up the port. 


Attempt to write to non-existent memory 
The memory location is not defined in the architecture file. 


Attempt to write to ROM 
The destination of a memory write is a location declared as ROM in the 
architecture file. 


Break expression doesn't exist 
The break expression cannot be deleted because the expression number 
given does not exist. 


leSSages 


Breakpoint already exists at that address 
A breakpoint is already set at the specified address. 


Breakpoint doesn't exist at that address 
A breakpoint cannot be deleted because no breakpoint is set at the 
address (label) given or the breakpoint number given does not exist. 


Breakpoint occurrence number is invalid 
The number selected for the breakpoint is outside the acceptable range 
(1-20). 


Breakpoints in PM only 
Breakpoints and break ranges may not be set in boot or data memory. 


Breakpoint table is full 
The maximum number of breakpoints (20) is already set. 


Cannot command plot from file 
You cannot use the Plot command in a script file. 


Cannot open architecture file filename 
The file is missing, the open files limit has been exceeded or you have 
insufficient privilege to open the file. 


Can only set ROM enable with 2151 parts 
The ROMENABLE bit can only be set on the ADSP-21msp51. 


Can't create filename for memory cache 
Check whether the number of open files exceeds the limit defined in the 
config.sys file (PC users); a limit of 25 is recommended. 


Can't create temporary window file 
The simulator can’t make a temporary file, check the TMP environment 
variable. 


Can't create window file 
An operating system error occurred, the open files limit has been 
exceeded, or you have insufficient privilege to write the file. 


Can't find instruction in DM 
Data memory must contain numerical data—not instructions; only boot 
memory and program memory can contain instructions. 


Can't find or can't open executable file 
The executable file is missing, the open files limit has been exceeded or 
you have insufficient privilege to open the file. 


Can't find or can't open file 
The file is missing, the open files limit has been exceeded or you have 
insufficient privilege to open the file. 


Can't find or can't open help file 
The help file is damaged or not present, or the ADI_DSP environment 
variable is not properly set. Check installation instructions and reinstall 
help files. 


Can't find or can't open keystroke file 
The keystroke file is missing, the open files limit has been exceeded or 
you have insufficient privilege to open the file. 


Can't find or can't open symbol file 
The symbol file is missing, the open files limit has been exceeded or you 
have insufficient privilege to open the file. 


Can't initialize help system 
The help file is damaged or not present, or the ADI_DSP environment 
variable is not properly set. Check installation instructions and reinstall 
help files. 


Can't load window file 
The .win file is missing, the open files limit has been exceeded or you 
have insufficient privilege to open the file. 


Can't read from file 
The file is missing, the open files limit has been exceeded or you have 
insufficient privilege to open the file. 


Can't write to file 
The file is missing, the open files limit has been exceeded or you have 
insufficient privilege to open the file. 


Can't write window file 
The .win file is missing, the open files limit has been exceeded or you 
have insufficient privilege to open the file. 


CE is a read only value 
Cannot write to the counter empty (CE) flag. 


Command syntax error — see help 
The command was entered improperly; refer to the help file or user’s 
manual for the correct syntax. 


Counter is undefined 
A counter-based loop was executed without initializing CNTR first. 


Could not find 
The value or instruction specified for the Find command is not present 
in the address range specified. 


Divide by zero in expression 
Arithmetic error. 


Dump not allowed from this window 
You can only dump memory from the prograra, data, or boot memory 
windows. 


Encountered end of file reading port 
The program finished reading the input file. 


Encountered end of HIP input file 
Warning only—the simulator finished reading the data supplied by the 
HIP input file. 


Encountered end of SPORT 0 input file 
Warning only—execution is halted when no more data is available. 


Encountered end of SPORT 1 input file 
Warning only—execution is halted when no more data is available. 


Error: I reg is outside of buffer 
The I register for a circular buffer was modified to a location outside the 
buffer; modulo addressing is no longer valid. 


Error: M reg is greater than L reg 
The modify value must be less than length of circular buffer. 


Expecting an integer 
A non-integer value was given. 


Expression table full 
The maximum number of expressions allowed is 25. 


File is corrupted 
An internal DOS error occurred while accessing a file. 


File is empty 
The simulator attempted to read data from an empty file. 


Files must be single quoted 
Any file named in a command must be enclosed in single quotation 
marks (' '). 


Fill not allowed from this window 
The Fill command only works when given from program, data, and 
boot memory windows. 


Go To not allowed from this window 
The Go To command only works when given from program, data, and 
boot memory windows. 


Tllegal instruction 
The instruction is not a valid ADSP-2100 family instruction. 


Incompatible memory types 
The address range limits must both be in the same memory space. 


Insufficient memory to create window 
The amount of available RAM is exceeded; the new window cannot be 
opened until additional RAM is available. 


Internal error (windowing) 
Call Applications Engineering at (617) 461-3672 (Norwood, 
Massachusetts), (408) 559-2037 (California), or (32 2) 2371677 (Europe) 
for technical assistance. 


Interrupt number in invalid 
The interrupt number given does not represent a valid interrupt. 


Invalid alias to delete 
The symbol given does not exist in the alias list. 


Invalid architecture filefilename (PM>0x4000) 
The architecture file type does not match simulator program; e.g., an 
ADSP-2100 architecture file with the ADSP-2111 simulator. 


Invalid break range 
The maximum address limit for the break range is less than the 
minimum address for the break range, or the rnemory range is not 
defined in the architecture file. 


Invalid break specification 
You cannot delete a breakpoint because the break number given is not 
an integer, or the address (label) given is undefined. 


Invalid command 
The incorrect syntax was used for a command entered in the command 
window. 


Invalid ending DM address 
The address given in the plot memory command is an undeclared 
memory segment. 


Invalid ending PM address 
The address given in the plot memory command is in undeclared 
memory segment. 


Invalid expression 
An invalid operator or operand was used in a” or ?+ command. 


Invalid increment value 
The decimation value in the plot memory command must be a positive 
integer. 


Invalid plot size (max 640) 
The range length divided by the decimation value must be less than or 
equal to 640 to plot memory. 


Invalid range specification 
The range given is an undeclared memory seginent. 


Invalid stack type occurred 
Call Applications Engineering at (617) 461-3672 (Norwood, 
Massachusetts), (408) 559-2037 (California), or (32 2) 2371677 (Europe) 
for technical assistance. 


Invalid starting DM address 
The address given in the plot memory command is an undeclared 
memory segment. 


Invalid starting PM address 
The address given in the plot memory command is an undeclared 
memory segment. 


Keystrokes are already being recorded 
The simulator was already saving keystrokes to a file when the 
command was initiated. 


Keystroke recording 1S not in progress 
The simulator was not saving keystrokes to a file when the command 
was initiated. 


Load file contains data memory initialization 
This is a reminder that in an actual system, data memory must be 
initialized separately from program memory. This message appears in 
the command output window. 


Load not allowed from this window 
You can only execute the load command from the program memory 
window or command window. 


Loop stack has overflowed 
The number of specified loops was exceeded. 


Loop stack has underflowed 
The number of specified loops was not reached. 


MIN value is greater than MAX value 
The minimum interval for the Interrupt (I) command (periodic signal 
generation) must be less than or equal to the maximum interval. 


Mult error: frame sync came too early 
The RFSDIV value in multichannel mode is too low. 


Mult Receive enable register undefined 
Both multichannel word enable registers must be loaded. 


Mult Transmit enable register undefined 
Both multichannel word enable registers must be loaded. 


Need to set up a min or max — offset has no meaning 
You must set at least a minimum interval for the Interrupt (I) command. 


No input file for SPORTO 
No serial data is available to receive during program execution; a data 
input file must be assigned. 


No input file for SPORT1 
No serial data is available to receive during program execution; a data 
input file must be assigned. 


No output file for SPORTO 
The program is unable to transmit serial data during execution; a data 
output file must be assigned. 


No output file for SPORTI1 
The program is unable to transmit serial data during execution; a data 
output file must be assigned. 


No ports are available 
The ports specified in the architecture file are currently being used. 


Not a valid register 
A register must be a processor register or simulator-defined register. 


Not a valid serial port 
The serial port number must be 0 or 1. 


Only 20 profiles allowed 
You cannot exceed the maximum number of profile ranges. 


Operation not supported by this processor 
The selected command is not supported by the processor, for example, 
you cannot use the powerdown commands with the ADSP-2101 
simulator. 


Out of PC memory 
You need to free more memory to perform a function. Reboot the PC 
without loading any memory resident programs. 


PC stack overflowed 
The PC stack overflowed; there were too many nested subroutine calls 
or interrupt service routines. 


PC stack underflowed 
There was no return address on the PC stack when an RTI or RTS 
instruction was executed. 


Ports allowed only in DM or PM 
The I/O ports may not be located in boot memory. 


Port doesn't exist or isn't opened 
You cannot open a file for I/O port simulation if the I/O port has not 
been declared. 


Problem writing SPORTO output file 
The program execution is halted; the operating system is unable to 
write serial transmit data to an output file. 


Problem writing SPORT1 output file 
The program execution is halted; the operating system is unable to 
write serial transmit data to an output file. 


Read from port failed 
You cannot read from an I/O port simulation if the I/O port is not 
declared or open. 


Set/Clear Breakpoint not allowed from this window 
You can only set and clear breakpoints in the program memory 
window, or from the command window. 


SE undefined used in shift operation 
A shift instruction was executed without loading the shifter exponent 
(SE) register. 


Status stack has overflowed 
The status stack overflowed; there were too many nested subroutine 
calls or interrupt service routines. 


Status stack has underflowed 
There was no return address on the status stack when an RTI or RTS 
instruction was executed. 


Symbol doesn't exist 
The symbol is not specified in the symbol file. 


E-10 


Toggle not allowed from this window 
You cannot toggle the data format for this particular window. 


Tried to read from reserved memory 
Only reads from processor control registers are allowed in upper 1K of 
data memory. 


Tried to read past end of port input file 
The simulator tried to read more memory locations than the port input 
file contains. 


Tried to write to reserved memory 
Only writes to processor control registers are allowed in the upper 1K 
of data memory. 


Unable to assemble into DM 
The simulator can only load instructions into program or boot memory. 


Unable to delete expression 
The expression number does not exist in expressions window. 


Unable to delete watchpoint 
The watchpoint number does not exist in expressions window. 


Unable to open any more I/O ports 
The maximum number of I/O ports allowed is 25. 


Unable to open HIP Boot File 
You must specify a data file to simulate data from a host processor 
before the simulator can boot through the HIP. 


Undefined instruction 
The program memory location that was accessed does not contain an 
instruction. 


Undefined registers used in shifter 
A shift instruction was executed without the loading the data register. 


Undefined used in ALU operation 
An add or subtract instruction was executed without loading the input 
register. 


Undefined used in DAG 
The L, I or M register was not loaded prior to accessing memory. 


Undefined used in MAC operation 
The multiply instruction was executed without loading the input 
register. 


Undefined used in timer 


All three timer registers must be set: TCOUNT, TPERIOD and TSCALE. 


Unexpected EOF 
The file is damaged. 


Unexpected EOF in hip boot file 
The file is damaged. 


Unknown input type 
The signal name for the Interrupt (I) command was entered incorrectly. 


Usage: command syntax 
The command was entered incorrectly. Use the syntax shown. 


Warning analog interface undefined 
You are trying to access the ADSP-21msp50 analog interface operation 
without setting up the analog interface. 


Warning — interrupt not active (scnf1=0) 
A SPORT interrupt was requested (RFS1 or TFS1), but SPORT is not 
set up as a Serial port. 


Warning — interrupt not active (scnfl=1) 
An interrupt or flag status was requested (IRQO, IRQ1, or FL), but 
SPORT1 is set up as a serial port. 


Warning: undefined data contained in plot range 
The location(s) in the memory range to be plotted are not loaded with 
data. (Warning only—the simulator will attempt to create plot.) 


Watchpoint table full 
The maximum number of watchpoints allowed is 25. 
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Simulator Error 


Write to port failed 
The port is not defined in the architecture file, the open files limit has 
been exceeded or you have insufficient privilege to write to a port. 


Writing RAM segment to ROM in DM 
Warning only. 


Writing RAM segment to ROM in PM 
Warning only. 


Writing ROM segment to RAM in DM 
Warning only. 


Writing ROM segment to RAM in PM 
Warning only. 


Simulator Data File Formats 


F.1 OVERVIEW 


The .DAT file format is used for simulating data I/O in ports, SPORTs and 
the HIP, and for saving or loading simulated memory. The formats are 
detailed in this appendix. The .DAT extension for data files is a DOS 
convention only and is not required by the simulator. 


These files contain text only: the characters for hexadecimal, decimal, and 
binary data. Any standard text editor can be used to create the files. 


F.2 I/O PORT DATA 


You must create an I/O port data file to provide input data to parallel 
ports in DM or PM. The file format is one number per line. Carriage 
returns are ignored by the simulator. 


Three formats are supported: 


e Hexadecimal format requires a four-digit number for DM-mapped 
ports, and a six-digit number for PM-mapped ports. If there are more 
than the required number of digits, the simulator reads in the four or 
six least significant digits. The numbers should not contain the 0x 
prefix. Examples: 0FOF, ABCDEF 


e Decimal format recognizes integers from —32768 to +32767 inclusive. 
Examples: 543, -12 


e Floating-point format includes numbers in the range -1 <x < 1, 
expressed as a mantissa, the letter “e” and an exponent. The mantissa 
and exponent may be signed. Examples: 0.314159, 
314.159E-5 


If data is written out to a port, the simulator opens a file to store the 
output data. The format is determined by a menu item from the pop-up 
window or by the current data format of the command window. 


F.3 SPORT DATA 


You must create a file to provide simulated (receive) serial data to the 
serial ports. The input file must consist entirely of 1s, 0s, and carriage 
returns. A single line in the file may have any number of 1s and 0s; 
carriage returns may be used to terminate each line and make the file 
more readable. The simulator reads the ASCII characters and ignores 
carriage returns. 


The simulator opens a file to store output (transrait) data. 


F.4 HIP DATA 


You must create a file to provide simulated host data to the HIP. The HIP 
supports data widths of 8 bits or 16 bits and should be configured for the 
width of the input data file. The file format is 


e for 8-bit data, one two-digit hexadecimal number per line, or 
e for 16-bit data, one four-digit hexadecimal number per line. 


If there are more than the required number of digits, the simulator reads 
in the two or four least significant digits. The numbers should not contain 
the Ox prefix. The simulator opens a file to store data output from the HIP. 


FO SIMULATED MEMORY DATA 


Portions of PM or DM can be saved to or loaded from an external file 
using the Dump (D) command to save and Fill (F) command to load. The 
file format for data to be loaded with the Fill command is 


e for DM, one four-digit hexadecimal number per line, and 
e for PM, one six-digit hexadecimal number per line. 


If there are more than the required number of digits, the simulator reads 
in the four or six least significant digits. The numbers should not contain 
the Ox prefix. 


Saving data with the Dump command is useful for intermediate storage of 
simulated PM or DM contents. The data can be reloaded later or input to 
other software applications. 
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Development Software Invocation Commands 


System Builder 


Switches 
=—C 


Assembler 


Switches 

=¢ 

=] 

—-m [depth] 

-1 [depth] 

-o filename 
-—dident [=literal] 
—9 


Linker 
or 


Switches 

-a archfile 

~1 file Git 

-e executable 
—dryrun 

mc) 

—x 

lib 

-user fastlibr 


“Gir Girectory; ... 


“P 


Librarian 
or 


Switches 
—-v version 
=4 £1146 ell 


Simulators 


Switches 

-a archfile 
-e exe file 
“eo 

-k keyfile 
-o msgfile 
-w winfile 


bld21 sys file [-c] 


Case-sensitivity for architecture file symbols 


asm21 sourcefile [-switch ...] 


Case-sensitivity for program symbols 

.LST list file generated 

Macros expanded in .LST file 

Show contents of INCLUDE files in .LST file 
Rename output files (default: SOURCEFILE. OBJ) 
Define identifier for assembler’s C preprocessor 

No semantics checking on multifunction instructions 


ld2l filel [file2 ..] [-switch ...] 
ldZi -1 file ail [-switch ...] 


. ACH architecture file read by linker (default: 210X. ACH) 

Files listed in indirect file file_all are linked 

Output files given filename EXECUTABLE. EXE (default: 210X. EXE) 
Quick run to test for link errors (no .EXE file generated) 

SYM symbol table file generated 

.MAP memory map file generated 

ADSP-21xx Runtime C Library linked 

Search library file generated by librarian 

Specify directories to search for library routines 

Assign library routines to boot pages where called 


lib2l 126 name filel [file2 ..] [-v version] 
Jib2l 115 name -1 file all [-v version] 


Embed version number in library file created (lib_name) 
Files listed in indirect file file_all are taken as input 


Sim2100 [-Switch ...] 
sim2101 [-switch ...] use also for 2105, 2115 
Sim2111 [-switch ] 
sim2150 [-switch ] 


.ACH architecture file read by simulator (default: 210X. ACH) 

.EXE program file loaded by simulator 

Case-sensitivity for program symbols 

Load and execute keystroke file 

Generate file containing error messages and Command Output Window messages 
Simulator starts up with previously saved windows display file (. WIN) 


C Compiler 
or 


Source (Input) File 
Filename Extension 

aC 

«fH 

ae | 

-asm or.dsp or.s 
.is 

.obj 

Pel 


Switches 

-a archfile 
= 
—Dmacro[ 
“Gg 
-Idirectory 
-Ldirectory 
-llibrary name 
—map 

-o filename 
-runhdr filename 
-save-temps 

=§ 

—-Umacro 

-V 


=defn] 


-—w 
—W 
-Wall 


(Note: For a complete list of switch options, refer to the ADSP-2100 Family (C Tools Manual) 


PROM Splitter 


or 
or 
or 


Switches 
pm 
—dm 


“YSZ 

Ui. 

-bs pagesize 
-bb boundary 
-loader 


HIP Splitter 
Switches 

—i 

—boot 


g21 sourcefile 
G42 Urije als 


File Contents and 
Translation Operation 


C source to be preprocessed 

Macro or header file to be preprocessed 
C source to be compiled 

Assembler source to be preprocessed 
Assembler source to be assembled 


Object file to be linked 


[sourcefile ...] 
[=Sswitch ..«| 


Output File 


[-switch ...] 


{ source files listed 
in file all 


Filename Extension 


Library file of function definitions 


.ACH architecture file read by compiler 
Compile (and/or assemble) only, without linking 


Define macro 


Generate debugging information for simulator’s C source debugger (CBUG) 
Include search directory (append directory to search path for include files) 
Library search directory (linker appends directory to search path for library files) 
Link library file (linker searches library file for functions) 


Direct linker to generate .map memory map file of symbols 


Select filename for final output files 
Direct linker to use the specified runtime header file ( default: 2105_hdr.obj) 


Save temp files (. i, .s, 


Stop after compiling, without assembling (.s file generated) 


Undefine macro 


.is) 


Verbose—compiler prints commands issued to execute each stage 
Warnings off—compiler inhibits all warning messages 


Warnings extra—compiler issues extra warning messages 


Warnings all—compiler issues all recommended warning messages 


spl2il exe file 
splzl exe fale 
spl2Zil exe fale 
Splzl exe file 


promfile -pm [-Switch ... 
promfile -dm [-Switch ... 
promfile -bm [-Switch ... 
promfile -loader [-s] 


Extract program memory ROM information 
Extract data memory ROM information 
Extract boot memory ROM information 
PROM file format: Motorola S record (default) 
PROM file format: Intel Hex record 

PROM file format: Motorola S record byte stream (do not use with —bm) 
PROM file format: Motorola $2 record byte stream (do not use with —bm) 
PROM file format: Intel Hex record byte stream (do not use with —bm) 
Select boot page size (default=2K) 

Select boot page boundaries (default=2K) 
Generate boot code with memory loading rout:nes 


heplél exe fiie 


(atare addr] 


PROM file format: Intel Hex record (default: -s) 
Ordering of 24-bit program memory words: High byte, Low byte, Middle byte 
(default: High byte, Middle byte, Low byte) 


[-1] 


[ 


=bOot | 


System Builder Directives 
. SYSTEM system name; 


-ADSP2Z1xx; 21xx= 2100, 2101, 2105, 2111, 2150, 
. MMAP x; {x=0,1} 2101P (2101 paged memory system) , 
.CONST constant name=expression; 2101MV (2101 memory variant—use for 2115, 216x) 


.SEG/qualifier/qualifier/.. seg _name[length]; 
.PORT/qualifier/qualifier port name; 
. ENDSYS; 


.SEG qualifiers: PM,DM, BOOT=0,1,2,3,4,5,6,7 -PORT qualifiers: PM, DM 
RAM, ROM ABS=address 
ABS=address 
DATA, CODE, DATA/CODE 
EMULATOR, TARGET 
INTERNAL (for ADSP2101MV) 


Assembler Directives 


.MODULE/ qualifier/qualifier/... module_name; 
» PAGE; 

CONST constant_name=expression; 
.VAR/qualifier/qualifier/... buffer name[{length],...; 
. INIT buffer name: init_values; 

.GLOBAL buffer name, ...; 

- ENTRY program label, ...; 

. EXTERNAL external symbol, ...; 

-PORT port name; 

. INCLUDE <filename>; 

. DMSEG dmseg_name; 

.MACRO macro_name (paraml, param2, ...); 


. ENDMACRO; 

~LOCAL macro Jabel » «.% 

. NEWPAGE; Insert pagebreak in .LST file 

.PAGELENGTH #lines; Insert pagebreaks every #lines in .LST file 

. LEFTMARGIN #columns; Set left margin in .LST file 

. INDENT #columns; Indent code #columns in .LST file 

.PAGEWIDTH #columns; — Set right margin in .LST file 

. ENDMOD ; 

MODULE qualifiers: RAM, ROM .VAR qualifiers: PM, DM, 
ABS=address (do not use with STATIC) RAM, ROM 
SEG=seg_name ABS=address (do not use with STATIC) 
BOOT=0,1,2,3,4,5,6,7 SEG=seg_name 
STATIC CIRC 

STATIC 


INIT init_values: constant, constant, ... 
<filename> 
“other_buffer 
Zoother_buffer 
Assembler C Preprocessor Directives 


#define macro name(paraml,...) expression Define a macro 
#undef macro_name Undefine a macro 
#include “filename” Include text from another source file 
#if expression Conditionally include and assemble, depending on the value of 
an expression that evaluates to a constant 
#else Include and assemble if the previous #1 f test failed 
#endif 


#ifdef macro name Conditionally include and assemble, if macro_name is defined (with #define or —d switch) 
#ifndef macro name Conditionally include and assemble, if macro_name 1s not defined 

#else Include and assemble if the previous #ifdef or #ifndef test failed 

#endif 


Instruction Set Summary 


ALU Instructions 
[IF cond] | AR = xop + yop ; Add/Add with Carry 
AF C 
yop +C 
= xop — yop ; Subtract X-Y/Subtract X—-Y with Borrow 
-yop+C-1 
+C-1 
=|yop - _ | xop Subtract Y-X/Subtract Y—X with Borrow 
| xop+C-1 
—xop +C-1 
= xop |AND|_ yop : AND, OR, XOR 
OR 
XOR 
= PASS | xop| ; Pass, Clear 
yor 
-1 
0 
1 
=  —-  |xop| ; Negaie 
| yop 
= NOT | xop] ; NOT 
ia 
0 
= ABS Xop ; Absolute Value 
= yop + 1; Increment 
= yop - 1; Decrement 
= DIVS _ yop, xop; Divide 
= DIVO xop; 


Notation Conventions 


UPPERCASE Explicit syntax—must be entered exactly as shown (either lowercase or uppercase may be used, however) 
10-I7 Index registers for indirect addressing 


M0O-M7 Modify registers for indirect addressing 

LO-L7 Length registers for circular buffers (set to 0 for non-circular indirect addressing) 
<data> Immediate data value 

<addr> Immediate address value (absolute address or program label) 

<exp> Exponent (shift value) in shift immediate instructions (8-bit signed number) 
cond Condition code for conditional instruction 

term Termination code for DO UNTIL loop 

dreg Data register (of ALU, MAC, or Shifter) 

reg Any register (including dregs) 


A semicolon terminates the instruction 
Commas separate multiple operations of a single instruction 


[4 Brackets enclose optional parts of instruction 

oe Indicates multiple operations of an instruction that may be combined in any order, separated by commas. 
option1 
option2 List of options; choose one. 
option3 
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ALU Block Diagram 


PMD BUS 24 


16 (UPPER) 


DMD BUS 16 


AX x 
REGISTERS : 
2x16 : 


« * ; PT. 
RRS Seles sas 


ocererers 


REGISTER 


on 


$3 
sere! 


ectasstatatetetetetanbeateetetetetetstetetetotets 


es 


AR ss 
REGISTER 
3 


. 
TERRA RRR 


IF Condition Codes 

Cond 

EQ Equal zero 

NE Not equal zero 

LT Less than zero 

GE Greater than or equal zero 
LE Less than or equal zero 
GT Greater than zero 

AC ALU carry 

NOT AC Not ALU carry 

AV ALU overflow 

NOT AV Not ALU overflow 

MV MAC overflow 

NOT MV Not MAC overflow 
NEG Xop input sign negative 
POS Xop input sign positive 
NOT CE Not counter expired 
FLAG _IN * FI pin=1 

NOT FLAG_IN* _ FI pin=0 

* Only for JUMP, CALL 


Allowed XOP, YOP Registers 
for ALU Instructions 


xop AXO, AX1 

AR 

MRO, MR1, MR2 
SRO, SR1 


yop AYO", AY1 


AF 


" DIVS instruction may not use AYO as YOP operand. 


Instruction Set Summary 


MAC Instructions 


[IF cond] pe = 
MF 


IF MV SAT MR; 


Xop * yop 


MR + xop yop 


MR —- xop+*yop 


MR [(RND) ]; 


(S) Signed input (xop, yop) 
(U) Unsigned input (xop, yop) 


(RND) Rounded output 


IF Condition Codes 

Cond 

EQ Equal zero 

NE Not equal zero 

LT Less than zero 

GE Greater than or equal zero 
LE Less than or equal zero 
GT Greater than zero 

AC ALU carry 

NOT AC Not ALU carry 

AV ALU overflow 

NOT AV Not ALU overflow 

MV MAC overflow 

NOT MV Not MAC overflow 
NEG Xop input sign negative 
POS Xop input sign positive 
NOT CE Not counter expired 
FLAG _IN * FI pin=1 


NOT FLAG _IN* — FI pin=0 


* Only for JUMP, CALL 
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Multiply 


Multiply/Accumulate 


Multiply/Subtract 


Transfer MR 


Clear 


Conditional MR Saturation 


Allowed XOP, YOP Registers 


for MAC Instructions 
xop MX0, MX1 
MRO, MR1, MR2 
AR 
SRO, SR1 


MAC Block Diagram 


PMD BUS 24 


16 (UPPER) 


DMD BUS 16 


REGISTERS 


X Y 
MULTIPLIER 
P 


ADD / SUBTRACT 
R 


2 R1 RO 


MR2 


g MRO z 
REGISTER [4 
3 


REGISTER : 


HK CNA 58 EIR AAAS 


Sed 


MR Registers 
40 32 31 16 15 0 


| Overflow | Most Significant 16 Bits Least Significant 16 Bits 


Instruction Set Summary 


Shifter Instructions 


[IF cond] SR 


[IF cond] SR 


[IF cond] SR 


[IF cond] SE 


[IF cond] SB 


SR 


SR 


(HI ) 


I| 


[SR OR] ASHIFT xop 


[SR OR] LSHIFT xop 


[SR OR] NORM xop 


EXP xop 


EXPADJ xop ; 


[SR OR] ASHIFT xop BY <exp> 


[SR OR] LSHIFTxop BY <exp> 


(HI) 
(LO) 


J 


(HI) 
(LO) 


ig 


J 


(HI) 
(LO) 


(HI) 
(LO) 
(HIX) 


J 


(HI) | ; 
(LO) 


(HID) || 3 
(LO) 


Shift is referenced to SR1 (most significant 16 bits) 


(LO) Shift is referenced to SRO (least significant 16 bits) 
(HIX) Hl extend (AV overflow bit read by exponent detector) 
IF Condition Codes 

Cond 

EQ Equal zero 

NE Not equal zero 

LI Less than zero 

GE Greater than or equal zero 
LE Less than or equal zero 
GT Greater than zero 

AC ALU carry 

NOT AC Not ALU carry 

AV ALU overflow 

NOT AV Not ALU overflow 

MV MAC overflow 

NOT MV Not MAC overflow 

NEG Xop input sign negative 
POS Xop input sign positive 
NOT CE Not counter expired 
FLAG_IN * FI pin=1 

NOT FLAG_IN* _ FI pin=0 


* Only for JUMP, CALL 


Arithmetic Shift 
Logical Shift 
Normalize 


Derive Exponent 


Block Exponent Adjust 


Arithmetic Shift Immediate 


Logical Shift Immediate 
Allowed XOP Registers 
for Shifter Instructions 
xop SL SRO, SR1 
AR 
MRO, MR1, MR2 


Shifter Block Diagram 


DMD BUS 


NEGATE 


% 
% 
3 


OERRRRRR RRP OL ELIA 


SE & 
REGISTER 
8 


From 
INSTRUCTION 


SRO rf 
REGISTER ff 


SK 


ee YZ 
R-BUS 


Instruction Set Summary 


Data Move Instructions 


reg = reg; Register-to-Register Move 
reg = <data>; Load Register Immediate 
dreg = <data>; 
reg = DM (<addr>); Data Memory Read (Direct Address) 
dreg = DM(/|I0| , |MO)); Data Memory Read (Indirect Address) 
dreg = PM(|I4| , |M4)); Program Memory Read (Indirect Address) 
I5 M5 
16 M6 
[7 M7 
DM (<addr>) = reg; Data Memory Write (Direct Address) 
DM (|I0|, |M0O|) = dreg; Data Memory Write (Indirect Address) 
PM (|I4| , |M4|) = dreg; Program Memory Write (Indirect Address) 
15 M5 
16 M6 
[7 M7 
Allowed Registers for Data Move 
& Multifunction Instructions 
i— dreg 
(data registers) 
MRO, MR1, MR2 
SI, SE, SRO, SR1 
10, [1, 12, 13, 14, 15, 16, 17 
regs — MoO, M1, M2, M3, M4, M5, M6, M7 
LG, 1, L:2, 63, L4, LS, Le, L7 
TXO, TX1, RXO, RX1 
SB, PX 
ASTAT, MSTAT 
SSTAT (read-only) 
IMASK, ICNTL 
IFC (write-only) 
10 CNTR 
OWRCNITR (write-only) 


Multifunction Instructions 


<ALU> 
<MAC> 
<SHIFT> 


, dreg = dreg; Computation with Register-to-Register Move 


<ALU> 
<MAC> 
<SHIFT> 


, dreg = |DM(|I0| , |MO})| ; Computation with Memory Read 


DM (|10| , |MO})| = dreg , |<ALU> | ; Computation with Memory Write 
Il Ml <MAC> 
<SHIFT> 
PM (|14| , |M4!) 
I5 M5 
16 M6 
17 M7 
AX0| = DM (/I0| , |MO}) ; AYO | = PM(|I4) , |M4/) ; Data & Program Memory Read 
AX1 [1 M1 AY1 15 M5 
MX0 2 M2 MYO 16 M6 
MxX1 13 M3 MY1 iW M7 
<ALU>| , |AX0|=DM(|I0|, |MO|})~ , AYO |= PM(\I4! , |M4/) ; ALU/MAC with Data & Program 
<MAC> AX1 Il} |M1 AY1 15 M5 Memory Read 
MX0 [2 M2 MY0 16 M6 
MxX1 13 M3 MY1 17 M7 


<ALU>*t = Any ALU instruction (except DIVS, DIVQ) 
<MAC>*t = Any multiply /accumulate instruction 
<SHIFT>* Any shifter instruction (except Shift Immediate) 


* May not be conditional instructions 
+ AR, MR result registers must be used—not AF, MF feedback registers 
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Instruction Set Summary 


Program Flow Instructions 


DO <addr> [UNTIL term] ; 


[IF cond] JUMP 


[IF cond] CALL (14) |; 
(15) 
(16) 
(17) 
<addr> 
IF eee JUMP) <addr> ; 
NOT FLAG _IN CALL 
[IF cond] |SET FLAG OUT 
RESET FLO 
TOGGLE FL1 
FL2 


[IF cond] RTS; 


[IF cond] RTI; 


IDLE [(n)]; 
n=16, 32, 64, or 128 


DO UNTIL Termination Codes 


Term 

CE Counter expired 

EQ Equal zero 

NE Not equal zero 

LT Less than zero 

GE Greater than or equal zero 
LE Less than or equal zero 
GT Greater than zero 

AC ALU carry 

NOT AC Not ALU carry 

AV ALU overflow 

NOT AV Not ALU overflow 

MV MAC overflow 

NOT MV Not MAC overflow 
NEG Xop input sign negative 
POS Xop input sign positive 
FOREVER Always 
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Lp x 


ni 


Do Until 


Jump 


Call Subroutine 


Jump/Call on Flag In Pin 


Modify Flag Out Pin 


Return from Subroutine 


Return froin Interrupt Service Routine 


Idle 

IF Condition Codes 

Cond 

EO Equal zero 

NE Not equal zero 

LT Less than zero 

GE Greater than or equal zero 
LE Less than or equal zero 
GT Greater than zero 

AC ALU carry 

NOT AC Not ALU carry 

AV ALU overflow 

NOT AV Not ALU overflow 

MV MAC overflow 

NOT MV Not MAC overflow 
NEG Xop input sign negative 
POS Xop input sign positive 
NOT CE Not counter expired 
FLAG _IN* FI pin=1 

NOT FLAG IN* FI pin=0 


* Only for JUMP, CALL 


Miscellaneous Instructions 


NOP ; NOP 


MODIFY (|10) , |MO ); Modify Address Register 
Il M1. 


Hee STS] [,POPCNTR] [,POPPC] [,POP LOOP]; Stack Control 
POP 


Eg SEC_REG Ll; Mode Control 
DIS | | BIT_REV 

AV_LATCH 
AR SAT 
M_MODE 


Modes 
aor SEC_REG Secondary register set 
~ BIT_REV Bit-reverse addressing in DAG1 
AV_LATCH ALU overflow (AV) status latch 


AR_SAT AR register saturation 
M_MODE MAC result placement mode 
TIMER Timer enable 


G MODE Go mode enable 


Circular Buffer Addressing 
Next Address = (I + M-B) modulo(L) + B 


I=current address M=modify value (signed) M<sL 
B=base address L=buffer length 


(Set L=0 for standard, non-circular indirect addressing: 1+M=modified address) 


Buffer Length & Base Address Operators 


“buffer_name Base address of buffer_name 
$buffer_name — Length (number of locations) of buf fer_name 


Example: Setting Up DAG Registers for Circular Buffer & DO UNTIL Loop 


. VAR/DM/RAM/CIRC real_data[n] ; {n=number of input samples} 
15=*real_data; {buffer base address} 
L5=%real_data; {buffer length} 
M5=1; {post-modify I5 by 1} 
CNTR=%real_data; {loop counter = buffer length} 
DO loop UNTIL CE; 

AX0=DM(15,M5) ; {get next sample} 


{now process sample stored in AXx0} 
loop: i 13 


Control/Status Registers 


System Control Register 


15 14 13 12 11109 8 7 6 5 4 3 2 1 #0 


SPORTO Enable 

1 = enabled, 0 = disabled _ Natya Mise Big 

(must be set to 0 for ADSP-2105) PWAIT 

SPORT1 Enable Program Memory 
1 = enabled, 0 = disabled Wait States 
SPORT1 Configure ae esis 


1 = serial port 
0 = Fl, FO, IRQO, IRQ1, SCLK 
BFORCE BPAGE 
Boot Force Bit Boot Page Select 


Data Memory Waitstate Register 


14 
PPE E LOE EE SESE] emma 


eon al el ae aan al nal 


ROM Enable (ADSP-21msp56 only) 


bated (Set to 0 for all other processors) 


Timer Registers 


15 14 13 12 11109 8 7 6 5 4 3 2 1 0 
TCOUNT Counter Register DM(0x3FFC) 
e ES : es ae TSCALE Scaling Register DM(0x3FFB) 


Control register default bit values at reset are as shown; if no value is 
shown, the bit is undefined after reset. Reserved bits are shown on a gray 
field—these bits should always be written with zeros. 
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mirage — = Not on ADSP-2105 
14 10 9 


PEEP Guo QU IKK) I baat 


Multichannel Enable MCE an rn ae 
SLEN (Serial Word L ~ 
Internal Serial Clock Generation ISCLK Pe Se Lene) 
- : DTYPE Data Format 
Receive Frame Sync Required RFSR 00=right justify, zero-fill unused MSBs 
Receive Frame Sync Width RFSW 01=right justify, sign-extend into unused MSBs 
10=compand using i-law 
Multichannel Frame Delay MFD 11=compand using A-law 
Only If Multichannel Mode Enabled INVRFS Invert Receive Frame Sync 
Transmit Frame Sync Required TFSR INVTFS Invert Transmit Frame Sync 
(or INVTDV Invert Transmit Data Valid) 
Transmit Frame Sync Width TFSW Only If Multichannel Mode Enabled 
IRFS Internal Receive Frame Sync Enable 


ITFS Internal Transmit Frame Sync Enable 
(or MCL Multichannel Length: 1=32 words, 0=24 words) 


Only If Multichannel Mode Enabled 


SPORTO pone = Not on ADSP-2105 


15 14 13 12 11 10 9 


LTT LEE] oor 


ae ae 


TIREG TMREG RIREG RMREG 


TBUF Transmit Autobuffering Enable 


RBUF Receive Autobuffering Enable 


CLKOUT frequency 
V= IS 1 
aint 2 * (SCLK frequency) 
SPORTO BELLY Not on ADSP-2105 
15 14 13 12 11 10 9 8 7 6 4 3 2 1 #0 
DM(0x3FF5) 
SCLK frequency 
FSDIV= ———_+——_~ -1 
ai RFS frequency SPORTO RFSDIV Not on ADSP-2105 
15 14 13 12 11 10 9 4 3 2 1 +O 
DM(0x3FF4) 


SPORTO0 Multichannel Word Enables Not on ADSP-2105 


31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 


: DM(0x3FFA) 
Receive 
Word 145 14 13 12 11109 8 7 6 5 4 3 2 1 ~«0 
Enables 
DM(0x3FF9) 
1=Channel Enabled 
0=Channel Ignored 
31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 
. DM(0x3FF8) 
Transmit 
Word 15 14 13 12 1110 9 8 7 6 5 4 3 2 1 «0 
Enables 
DM(0x3FF7) 
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anus Control ee 


15 14 13 12 10 9 


PEPE EEE Pee] omar: 


Flag Out (read-only) a ao |. 
SLEN (Serial Word Length — 1) 
Internal Serial Clock Generation (ISCLK) 
er S . — Data Format 
eceive Frame Sync Required (RFSR) 00=right justify, zero-fill unused MSBs 
Receive Frame Sync Width (RFSW) ri Hanah Pg a 
Transmit Frame Sync Required (TFSR) 11=compand using A-law 
INVRFS) Invert Receive Frame S 

Transmit Frame Sync Width (TFSW) a acta sii 

Internal Transmit Frame Sync Enable (ITFS) Pee une peneare a vane on gee 


(IRFS) Internal Receive Frame Sync Enable 


SPORT1 Autobuffer Control Not on ADSP-21msp50 
15 14 13 12 11 10 9 8 7 6 5 4 _ 2 1 0 


| [ele DM(0x3FEF) 


TIREG TMREG RIREG RMREG 
TBUF Transmit Autobuffering [:nable 


RBUF Receive Autobuffering E:nabile 


CLKOUT frequen 
ScLEDIV= res. le 
2 * (SCLK frequency) 


SPORT1 SCLKDIV 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 O 
| DM(0x3FF1) 
SCLK frequenc 
RISD: eee 
RFS frequency SPORT RFSDIV 


15 14 13 12 11 10 9 4 3 


2 1 +O 
| DM(0x3FFO0) 
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Analog Control Register ADSP-21msp50 only 
15 14 13 12 1110 9 8 7 6 5 4 3 2 1 «0 


| al 
IPS6 == = IPS20 


ADC Input Preamplifier Select ADC Input Preamplifier Select 
1=insert (+6dB), O=bypass (0dB) 1=insert (+20dB), 0=bypass (0dB) 
DABY IMS 
DAC High Pass Filter Bypass ADC Input Multiplexer Select 
1=bypass, O=insert 1=AUX input, O0=NORM input 
ADBY OG2, OG1, OGO 
ADC High Pass Filter Bypass DAC Output Gain (for PGA) 
1=bypass, O=insert . 
¥P Gain | OG2 OG1 OGO 
APWD +6 dB 0 0 0 
Analog Interface Powerdown +3 dB 0 0 1 
0=powerdown, 1=enable 0 dB 0 1 0 
(set both bits to 1 to enable analog interface) -3 dB 0 1 1 
-6 dB 1 0 0 
-9 dB 1 0 1 
-12 dB 1 1 0 
-15 dB 1 1 1 


Gain settings are accurate within +0.6 dB 


Analog Autobuffer/Powerdown Control = ADSP-21msp50 only 
15 14 13 12 1110 9 8 7 6 5 4 3 2 1 #0 


DM(0x3FEF) 

XTALDIS ARBUF 

XTAL Pin Disable During Powerdown ADC Receive Autobuffer Enable 
1=disabled, 0=enabled 

(XTAL pin should be disabled when ATBUF 

no external crystal is connected) DAC Transmit Autobuffer Enable 
XTALDELAY ARMREG 
Delay Startup From Powerdown 4096 Cycles Receive M register 


1=delay, 0=no delay 
(use delay to allow internal phase locked 
loop or external oscillator to stabilize) 


ARIREG 
Receive | register 


PDFORCE ATMREG 
Powerdown Force Transmit M register 
1=force processor to vector to 
powerdown interrupt ATIREG 


Transmit I register 
PUCR 
Powerup Context Reset 
1=soft reset, O=resume execution 


ADC Receive Data ADSP-21msp50 only 
15 14 13 12 11 10 9 8 YT 6 5 4 3 2 1 #90 
DM(0x3FED) 
DAC Transmit Data ADSP-21msp50 only 
15 14 13 12 11109 8 7 6 5 4 3 2 1 =O 
DM(0x3FEC) 


No registers are located between DM(0x3FEC) and DM(0x3FE8) 
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HIP Interrupt Mask Register 


HMASK ADSP-2111 & 
5 4 3 2 0 ADSP-21msp50 only 


2 1 
e[ofo| DM(0x3FE8) 


| Host HDRO Write 

Host HDR1 Write 
Host HDR5 Read ————-._ Host HDR2 Write 
Host HDR4 Read —————_ Host HDR3 Write 
Host HDR3 Read —————_ Host HDR4 Write 
Host HDR2 Read —————_ Host HDR5 Write 


Host HDR1 Read 
Host HDRO Read 


Interrupt Enables 
1=Enable 


0=Disable 


HIP Status Registers 
HSR7 ADSP-2111 & 


15 14131211109 8 7 6 5 2 1 9 ADSP-21msp50 only 


4 3 
PEELE TTT] omooren 


_ 21xx HDRO Write 

21xx HDR1 Write 

——————_ 21xx HDR 2 Write 

OVERWRITE ————-_ 21xx HDR3 Write 
MODE 

————————_ 21xx HDR4 Write 

SOFTWARE ————- 21xx HDR5 Write 


RESET 


HSR6 ADSP-2111 & 
15 14 13 12 11109 8 7 6 2 1 0 ADSP-21msp50 only 


5 4 3 
ore of) fojofo|o : ‘oo fo 0 of o DM(0x3FE6) 


21xx HDR5 Write 
21xx HDR4 Write 
21xx HDR3 Write 
21xx HDR2 Write 
21xx HDR1 Write 
21xx HDRO Write 
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= Host HDRO Write 
Host HDR1 Write 
—————-_ Host HDR2 Write 

——————_ Host HDR3 Write 

———— Host HDR4 Write 

——————— Host HDR5 Write 


HIP Data Registers 


15 HDR5 0 ADSP-2111 & 
DM(0x3FE5) ADSP-21msp50 only 
15 HDR4 0 
DM(0x3FE4) 
15 HDR3 0 
DM(0x3FE3) 
15 HDR2 0 
DM(0x3FE2) 
15 HDR1 0 
DM(0x3FE1) 
15 HDRO 0 
DM(0x3FE0) 
Status Registers 
(Non-Memory-Mapped) 
ASTAT SSTAT (read-only) 
76 5 43 2 1 «0 7 65 43 2 1 0 


SS MV AQ AS AC AV AN AZ 


= PC Stack Empty 

ALU Result Zero 
ALU Result Negative PC Stack Overflow 
ALU Overflow Count Stack Empty 
ALU Carry Count Stack Overflow 
ALU X Input Sign Status Stack Empty 
ALU Quotient Status Stack Overflow 
MAC Overflow Loop Stack Empty 


Shifter Input Sign Loop Stack Overflow 


_ 


Mode Names for Mode Control Instruction 


| (see Miscellaneous Instructions on page 13) 
Register Bank Select 
O=primary, 1=secondary Bit Mode Name 
; , SEC_REG Secondary register set 
Bit-Reverse Addressing Enable (DAG1 ~ ay EG 
7 sini BIT_REV Bit-reverse addressing in DAG1 
ALU Overflow Latch Mode Enable AV_LATCH ALU overflow (AV) status latch 
, AR_SAT AR register saturation 
fn on eens Pere mine M_MODE MAC result placement mode 
MAC Result Placement TIMER Timer enable 


NOP WNF © 


O=fractional, 1=integer G_MODE Go mode enable 
Timer Enable 


Go Mode Enable 
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Interrupt Registers 
(Non-Memory-Mapped) 


ADSP-2101 
ADSP-2105 
aaa ADSP-2115 


INTERRUPT ENABLES 
Booguoe 
O0=disable 


IRQO Sensitivity 
IRQ1 Sensitivity 
IRQ2 Sensitivity 


—_— Timer 
naincel SPORT1 Receive or IRQO 
SPORT1 Transmit or IRQ1 
SPORTO Receive (must be set to 0 for ADSP-2105) 
Interrupt Nesting SPORTO Transmit (must be set to 0 for ADSP-2105) 
1=enable Iria? 
O=disable 


ara ADSP-2111 


INTERRUPT ENABLES 
Soggggooe— 
O0=disable 


IRQO Sensitivity Timer 

IRGi Sensitivity | }=rc9° SPORT1 Receive or IRQO 

IRQ2 Sensitivity IRQ2 SPORT1 Transmit or IRQ1 
HIP Write SPORTO Receive 

interrupt Nesting HIP Read 


SPORTO Transmit 
1=enable 
O0=disable 


I, ADSP-21msp50 
9 8 7 6 
INTERRUPT ENABLES 
Soguo0oouuR 
Laer 
IRQO Sensitivity — IRQ2 Timer 
iIRQ1 Sensitivity San a HIP Write SPORT1 Receive or IRQO 
IRQ2 Sensitivity HIP Read SPORT1 Transmit or IRQ1 
SPORTO Transmit ADC Receive 
Interrupt Nesting SPORTO Receive DAC Transmit 
1=enable 
0=disable 
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ADSP-2101 


_ FC ( write only) ADSP-2105 
1 10 9 ADSP-2115 


EEG CI a 


INTERRUPT FORCE BIT 
INTER RUE Tore eas INTERRUPT CLEAR BITS 
IRQ2 Timer 
SPORTO Transmit SPORT1 Receive or IRQO 
(must be set to 0 for ADSP-2105) SPORT1 Transmit or IRQ1 
SPORTO Receive SPORTO Receive 
(must be set to 0 for ADSP-2105) (must be set to 0 for ADSP-2105) 
; SPORTO Transmit 
SPORT! Transmit or IRQ1 (must be set to 0 for ADSP-2105) 
SPORT1 Receive or IRQO ROD 


Timer 


ae ( —— ADSP-21msp50 
as 13 12 10 9 


INTERRUPT FORCE BITS INTERRUPT CLEAR BITS 
IRQ2 Timer 
SPORTO Transmit SPORT1 Receive or IRQO 
(must be set to 0 for ADSP-2105) 


SPORT1 Transmit or IRQ1 


SPORTO Receive : 
(must be set to 0 for ADSP-2105) ADE Hecelve 
DAC Transmit DAC Transmit 
: SPORTO Receive 
ADC Receive (must be set to 0 for ADSP-2105) 
SPORT1 Transmit or IRQT SPORTO Transmit 
SPORT1 Receive or IRQ0 (must be set to 0 for ADSP-2105) 
Timer TRQ2 
ICNTL Rea ADSP-2100 
4 1 
INTERRUPT ENABLES 
1=enable 
O0=disable 

IRQO Sensitivity iRGO 

IRQ1 Sensitivity 1=edge iROQ1 

IRQ2 Sensitivity [| O=level IRQ2 

IRQ3 Sensitivity IRQ3 

Interrupt Nesting 

1=enable 

O=disable 
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Memory Maps 


Data Memory 
0x0000 
1K External 
DWAITO 
0x0400 
1K External 
DWAIT1 
0x0800 
EXTERNAL 
RAM 10K External 
DWAIT2 
0x3000 
1K External 
DWAIT3 
0x3400 
1K External 
DWAIT4 
1K Internal 0x3800 
(512 for 2105 & 2115) 
INTERNAL a 0x3C00 
RAM 
Ox3FFF 
ADSP-2101 
ADSP-2111 


Program Memory  ADSP-21msp50 


0x0000 0x0000 


INTERNAL 


RAM RAM 


Loaded From 
External 
Boot Memory 


0x07FF 
0x0800 EXTERNAL 


EXTERNAL 


0x3800 


INTERNAL 
RAM 


Ox3FFF Ox3FFF 


MMAP=0 MMAP=1 MMAP::0 


No Booting 
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INTERNAL 


Loaded From 
External 
Boot Mermory 


0x37FF EXTERNAL 


Program Memory 


0x0000 


| 0x03FF 


Ox3FFF 


ADSP-2105 


EXTERNAL 


INTERNAL 
RAM 


MMAP=1 
No Booting 


ADSP-2115 


0x0000 


Ox37FF 
0x3800 


Ox3BFF 
0x3C00 


Interrupt Vector Tables 


ADSP-2100 
Interrupt 
Source 

IRQO 

IRQ1 

IRQ2 

IRQ3 

RESET startup 


ADSP-2105 
Interrupt 
Source 


RESET startup 

IRQ2 

SPORT1 Transmit/IRQ1 
SPORT1 Receive /IRQO 
Timer 


ADSP-21msp50 
Interrupt 
Source 


Interrupt 
Vector Address 


0x0000 
0x0001 
0x0002 
0x0003 
0x0004 


Interrupt 
Vector Address 


0x0000 

0x0004 (high priority) 
0x0010 

0x0014 

0x0018 (low priority) 


Interrupt 
Vector Address 


RESET (or powerup w/PUCR=1) 0x0000 


Powerdown (non-maskable) 


IRQ2 

HIP Write from Host 
HIP Read to Host 
SPORTO Transmit 
SPORTO Receive 
Analog Transmit (DAC) 
Analog Receive (ADC) 
SPORT! Transmit/IRQ1 
SPORT1 Receive/IRQO 
Timer 


0x002C (high priority) 


0x0004 
0x0008 
0x000C 
0x0010 
0x0014 
0x0018 
0x001C 
0x0020 
0x0024 


0x0028 (low priority) 


ADSP-2101/2115 
Interrupt 
Source 


RESET startup 

IRQ2 

SPORTO Transmit 
SPORTO Receive 
SPORT1 Transmit/IRQ1 
SPORT1 Receive /IRQO 
Timer 


ADSP-2111 


Interrupt 
Source 


RESET startup 

IRQ2 

HIP Write from Host 
HIP Read to Host 
SPORTO Transmit 
SPORTO Receive 
SPORT1 Transmit/IRQ1 
SPORT1 Receive/IRQO 
Timer 


Interrupt 
Vector Address 


0x0000 

0x0004 (high priority) 
0x0008 

0x000C 

0x0010 

0x0014 

0x0018 (low priority) 


Interrupt 
Vector Address 


0x0000 

0x0004 (high priority) 
0x0008 

0x000C 

0x0010 

0x0014 

0x0018 

0x001C 

0x0020 (low priority) 
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Control/Status Registers 


Symbolic names for the memory-mapped control and status registers are provided in four files included 
with the development software. The symbols are defined as constants ecual to the register addresses, and 
can be used for direct addressing. To use these symbols, include the appropriate file in the your source 
code files with the assembler’s .INCLUDE directive: 


Filename Include Directive To Use: 
DEF2101.H . INCLUDE <DEF2101.H>; (use also for 2115) 
DEF2105.H . INCLUDE <DEF2105.H>; 
DEFZ111.H . INCLUDE <DEF2111.H>; 
DEF'2150.H . INCLUDE <DEF2150.H>; 
Data Memory — Assembly 

Control/Status Register Address Code Symbol 
System Control Register Ox3FFF Sys Ctrl Reg 
Data Memory Wait State Control Register = Ox3FFE Dm Wait Reg 
Timer Period Ox3FFD Tperiod Reg 
Timer Count OxSFFC Tcount_ Reg 
Timer Scaling Factor Ox3FFB Tscale Reg 
SPORTO Multichannel Receive Ox3FFA Sport0O Rx Words1l Not on 2105 

Word Enable Register (32-bit) Ox3FF9 Sport0 Rx Words0 Not on 2105 
SPORTO Multichannel Transmit Ox3FF8 Sport0 Tx Words1 Not on 2105 

Word Enable Register (32-bit) OxSPR7 Sport0 Tx Words0 Not on 2105 
SPORTO Control Register Ox3FF6 Sport0 Ctrl Reg Not on 2105 
SPORTO Serial Clock Divide Modulus Ox3FF5 Sport0 Sclkdiv Not on 2105 
SPORTO Rev Frame Sync Divide Modulus = Ox3FF4 Sport0O Rfsdiv Not on 2105 
SPORTO Autobuffer Control Register Ox3FF3 Sport0 Autobuf Ctrl  Noton 2105 
SPORT1 Control Register Ox3FF2 Sportl Ctrl Reg 
SPORT1 Serial Clock Divide Modulus OxSFFI Sportl Sclkdiv 
SPORT1 Rev Frame Sync Divide Modulus — Ox3FFO Sportl Rfsdiv 
SPORT1 Autobuffer Control Register Ox3FEF Sportl Autobuf Ctrl Not on 21msp50 
Analog Autobuffer/Powerdown Ctrl Reg = Ox3FEF Codec _Autobuf Ctrl 21msp50 only 
Analog Control Register Ox3FEE Codec_Ctrl*Reg 21msp50 only 
ADC Receive Data Register Ox3FED Codec_Rx Data 21msp50 only 
DAC Transmit Data Register Ox3FEC Codec_Tx Data 21msp50 only 
HIP Interrupt Mask Register Ox3FE8 Hmask Reg 2111, 21msp50 only 
HIP Status Register 7 Ox3FE7 HSR7_ Reg 2111, 21msp50 only 
HIP Status Register 6 Ox3FE6 HSR6_Reg 2111, 21msp50 only 
HIP Data Register 5 Ox3FES5 HSR5_ Reg 2111, 21msp50 only 
HIP Data Register 4 Ox3FE4 HSR4 Reg 2111, 21msp50 only 
HIP Data Register 3 Ox3FE3 HSR3_Reg 2111, 21msp50 only 
HIP Data Register 2 Ox3FE2 HSR2_Reg 2111, 21msp50 only 
HIP Data Register 1 Ox3FE1 HSR1_ Reg 2111, 21msp50 only 
HIP Data Register 0 Ox3FE0O HSRO_ Reg 2111, 21msp50 only 


Data Memory (RAM) 
Program Memory (RAM) 


Timer 

Serial Port 0 (multichannel) 
Serial Port 1 

Host Interface Port 

Analog Interface 


24 


2111 


21msp50/55/56 


ADSP-21xx Registers 


PROGRAM SEQUENCER 
~ ICNTL 


_ IFC ace eee 
SSTAT cumatengereans 
IMASK 
CNTR || MSTAT | 
OWRCNTR ASTAT 


STATUS 
STACK 


COUNT 
STACK 


Program Memory Address 

Data Memory Address 
Program Memory Data 
| DataMemoryData #§ ~—_—«Y Memory Data 


SHIFTER 


—_ 
SRO | SR1 | 


CONTROL REGISTERS WORKSHEET 


System Control Register 15 14 13 12 11 10 9 8 7 
Ox3FFF 


Data Memory Wait State 15 14 13 12 11109 8 7 
Control Register 
Ox3FFE 


Timer Period 15 14 13 12 11 10 9 8 7 
0Ox3FFD 


Timer Count 15 14 13 12 11 10 9 8 7 
Ox3FFC 


Timer Scaling Factor 15 14 13 12 11109 8 7 
Ox3FFB 


15 14 13 12 11 10 9 8 7 
Ox3FFA 


SPORTO Multichannel 


Receive Word Enable 
Register (32-bit) 15 14 13 12 11 10 9 8 7 


Ox3FF9 


15 14 13 12 11 10 9 8 7 
Ox3FF8 


SPORTO Multichannel 
Transmit Word Enable 
Register (32-bit) 15 14 13 12 11 10 9 8 7 


Ox3FF7 


SPORTO Control Register _15 14 13 12 11 10 9 8 7 
Ox3FF6 


SPORTO Serial Clock Divide 15 14 13 12 11 10 9 8 7 
Modulus 
Ox3FF5 


SPORTO Rev Frame Sync 15 14 13 12 1110 9 8 7 
Divide Modulus 
Ox3FF4 


CONTROL REGISTERS WORKSHEET 


SPORTO Autobuffer Control 15 14 13 12 11 10 9 8 7 


Register 
Ox3FF3 


SPORT1 Control Register 15 14 13 12 1110 9 8 7 


SPORT1 Serial Clock Divide 15 14 13 12 11 10 9 8 7 


Modulus 
Ox3FF1 


SPORT1 Rev Frame Sync 15 14 13 12 11 10 9 8 7 


Divide Modulus 
Ox3FFO 


SPORT1 Autobuffer Control 15 14 13 12 11 10 9 8 7 


Register 
Ox3FEF 


Analog Autobuffer/ 15 14 13 12 11 10 9 8 7 


Powerdown Control Register 
Ox3FEF 


ADSP-21msp50 only 
Analog Control Register 15 14 13 12 11 10 9 8 7 


0 


ADSP-21msp50 only 
HIP Interrupt Mask Register 15 14 13 12 11109 8 7 


HIP Status Register 7 15 14 13 12 11 10 9 8 7 


HIP Status Register6 (15 14 13 12 11 10 


9 8 7 6 5 3 1 O 


210X.EXE file (default) ................. 4-3, 4-8 
2 COMMENAING acevexesesnse 9-2, 9-20, 9-22, 12-5, 
12-6, 12-7, 12-8 


A 


et GSW IEC scotssxescasniovederavamorensss 7-5, 7-8, 8-2 
ABS qualifier ......... 3-23, 3-28, 4-11, 4-20 


Absolute address ..............c00000ee 4-11, 5-4 
Active WiNdOW ......ccccccccccceeessseeeseeeeeees 2-11 


“Address pointer” operator .............. 3-32 
PROTOSS CAN cccxicisinine scans ncniiositonneionee 6-5 
Addsymbol+ (ASYM+) command 

tree cocoate gona paieha ieee 9-28, 9-29 


ADIL....... 4-7,4-9, 4-13, 4-14, 4-15, 4-16 
ADIRTH environment variable.......... 4—7 


Pet OS aeancennenciancseceersmacss 1-12, 4-7 
ADS PAZ TOU csnaviiaanssse 1-2, 3-32, 10-9, A—4 


ADSP-2100 family ........ 6-1, 6-2, 6-3, 6-8 
ADSP-2102/ ADSP=2106 ws sncsoexsnnsinina sen 1-2 
PTB ZS wicaivasccosniesienssinnenesnciegsn 5-6, 5-7, 5-8 


ADSP-2105 reserved memory........... 2-14 
ADSP-2111 


pienso taie 5-6, 5-7, 5-8, 5-13, 5-14, B-6 
ADSPA20 1) BEA OT sxssennssnnisaamenaainnes 5-14 
ADSP-21msp50 simulator ......... 2-8, 5-14 
ADSP-21msp50/55/56 

facanesnd meta vit 2-8, 5-7, 10-9, 10-10, B-6 
ADSP-21xx Runtime C Library 

ee 4-5, 4-8, 4-16 
Aliases ...... 12-2, 12-3, 12-9, 12-10, 12-11 
Analog interface 

eaenenss 9-15, 11-1, 11-21, 11-22, 11-23 
IP VY LD ss seiesercexnsisascasnanescesstsasscnitin 9-15, 11-23 
PORTE incsottessavin venaeeenintans vehi 9-15, 11-22 
Architecture description file (ACH) 

‘citmeaaventinn 2-3, 3-23, 3-37, 4-1, 4-5, 4-6, 

4-10, 4-24, 6-2, 7-2, 7-5, 7-8, 8-2 


Arguments (macro) ........ 3-15, 3-39, 3-40 
PLR EGS oxscsrevsnenvisaneenxinncysemaies 9-15, 11-22 
ARMREG .....iecccceccccccccccsessseeees 9-16, 11-22 
Assemble (A) command ..............00008 9-26 
7 aN-<1-) 001 0) (-) ee 7-8, 7-26 
PGE IAA sccisaxsinisicrscaiandsseseanarincmenioess 9-8, 9-17 
FTE sass cscindaschemivtionsiansonanonns 9-15, 11-22 
PTR EGS cosscisnicsisanivivgsstioneassmvenscn 9-15, 11-22 
ATMREG ..9-15, 11-22, A-5, A-10, A-11 
B 

BVA POC CG sens seanienexveccen vivieassuntis 3-11, 4-23 
TE sieavsciiney ttasiaiansareadismmenbiminapaeiandnad caiaiiede 9-9 
IVER II E: sconesinecntovsicnanaissnentans consenyiarences 9-9, 10-5 
SEF INTL RUNG occa caiecouiscacennetncanienntietens 5-3, 5-4, B-6 
.BNM file ....5-3, 5-4, 10-4, B-6, B—-7, B-8 
SPST TAG ascccoiecavensensscenieasonieces 5-3, 5-4, B-6 
BOT Gia ateh icici urnmeesismucnwession 3-23, 3-24 
Boot address circuitry .............. 4-20, 4-22 
Boot force bit (BFORCE).......... 4-18, 10-5 
Boot loader ...........cccccsseeeeeees 5-2, 5-8, 10-4 


Boot memory (BM) window ...7—29, 9-32 

Boot memory (BM) .. 1-2, 2-7, 2-11, 3-23, 
3-24, 3-25, 3-35, 3-45, 4-25, 5-1, 5-2, 
5-3, 5-4, 5-5, 5-6, 5-7, 6-2, 6-7, 6-8 


Boot memory PROM........ 4-19, 4-25, 5-3 
BOOt MEMOLY WOES wz inscmxicinnensesanaontca B-4 
POG, PAPC IOOT ciswieswrcirisnasioamineede: 4—20 
POE Pa TIED aanensttieransecsiennnees 5-7, B-4 
Boot page select (BPAGE) ....0.....00065. 4-18 
BOOt PASC SIZE wccaserinsicarcennit #20), Ae, OP, 
5-6, 5-7, B-7 
BOO PARES sescseconns 2-11, 3-23, 3-24, 3-25, 
4-12, 4-15 
Boot PROM Tage TUE sccssssisseinasenonmes> 10-4 
Boot wait states (BWAIT) .............00.. 5-11 
Bootable code ...............05 3-24, 4-11, 4-12 
FOO ET Eis ssirnre 3-35, 3-36, 3-45, 4-12, 5-8 
DAE RSE, wssiscotnrtetceoncionneion ieienineninnt 9-9 
Break (B) command ................... 7-19, 7-32 
Breakdelete (BD) command.............. 7-21 
Breakpoint(s) .s..sosrcsanses 7-19, 7-20, 7-21, 


7-32, 7-33, 10-14, 10-15 


BRETT BOTIGTN ssscceasexevcresanmessaesuonasvansitoriics 3-30 
TE DAES siesitenceasnsesutaneinenentncates 5-5, 5-7 
Byte stream Tle s.csscncsveansens 5-1, B-7, B-8 
BOY ALT -ncconiaseissnnitenisntitencenenanmuvensnieesinene 9-9 
C 
SS COMPUED sicmisrcornis 1-10, 1-12, 2-3, 3-1, 

3-5, 3-6, 4-4, 4-6, 4-8, 4-9 
A PRUNE G OG sciisionshasseonaniacinranesiseancinion 1-9, 3-6 
K, LETS SS OPEPALOTS asicniesisrsssersnccassess 6-6 
Re EAE crust dnseraianina tcten inabattenieg 4-8, 4-16 
f. DICDTOCESBOE -iaceccasicnnsraramossnan: 3-3, 3-39 
C preprocessor directives .......... 3-3, 3-13 
—c switch ........ 44,46, 4-8, 4-9, 6-5, 8-3 
Cache Window ........cccccccccccsssssssceceseeees 9-29 
CANLBE LORIAING virsernisicossascisnrniindsonmnvaisosicedsisnns 4-9 
S| | em ne 4-14 
Case-Sensitivity ..........00sse00 2-3, 3-5, 6-4, 

6-5, 7-5, 8-3 
CE PSP ISET WINGOW sccoccsninncsiomnnnernns 9-10 
Changing a memory location ........... 9-24 
CAE ATERISIED sipsesiciniormnsamcsnnctans 9-2 
Changing a stack value... 9-18 
Chipreset (CR) command......... 7-30, 7-35 
Circ Command ...........ccceeeeeeeeeees 11-4, 11-8 
Circular buffer base address 

leseraindictheneitiia wate baebsincasetesanicenancih 3-30, 3-32 
Circular data buffers ........ 3-12, 44, 4-11 
Circular data file wo... 11-2, 11-4, 11-6, 

11-8, 11-18, 11-23 
Closing an 1/1) port 2.rccsoviscscrscanenavis 11-5 
CLOSING WINKOWS envssrcnrncsseavcnansen 7-11, 8-9 
Cntl-G (4G) command .............. cece 8-15 
Cntl-T (4T) command ...2—15, 2-19, 3-15 
8 a ae ee ees 9-6 
COE TNC LCDR) s ccscssceacrsicaamassieuss 3-1, 4-1 
Codeccycles (CC) command ............ 11-25 
Be) ei ge: 0s 1h ee 8-16 
Command line switches ............00000000. 7-5 
Computational registers window ......9-4 
COTMSCE COMMMANG, ssicssisicasssaseenissszcncs 11-12 
CCOMISTAINE scecncticonscosooconeavonvnensicns 6-4, 6-5, 6-6 
Control register addresses 

see enai eee teenies 3-16, 3-17, 3-20, 3-21 
Control registers window 

Arocsnipicnalbbeictenclireedanaaeidaetdanes 7-31, 7-33, 9-9 
(COUNESE SIAC fasacccaiieiiniesineeenseeiiunens 9-16 
Custom window configurations ......12-1 
BY hol ecaccacsicssawannnn apinadalcsivcannniintnaseaeenauscanes 9-6 
Ce COTS rete crt encanivionerreneet 7-34 


LIA 0 ecirevicacianseeeniceptcncinannnes 9-15, 11-23 
DIAC IRAN cissoccnssosscoensaseerise 9-15, 11-22 
TAGs INGEK PEC ISIS asonsniersssoinineanonncnnss 3-32 
DAG POP ISDETS a ccscsnsccedssancesssicnarssmonasenis 3-22 
DAG registers Wind OW .........+.s0+0 9-5, 9-6 
ALD FAL TINGS cascnsinstiseincesanoonareenesnernsieceianenn 4-3 
Datta Duthie scecesaceesenosnssoausnersseene 1-11, 3-11 
Data buffer initialization ............ B-1 
atte: Tile LOR ANS snsisennsnesssenrresaeetdereuenees F-1 
Data memory (DM)...... 5-1, 5-3, 6-5, 6-8 
Data memory (DM) window ............ 9-30 
Data variables .........ccccccccceeeceeeeees 1-11, 3-1 
LSC catecemnnueninnmanascida 6-4 
Decimal daa format ................ 11-25, F-1 
Default configuration file ............0. 12-1 
Default window file ...7—2, 7-6, 8-3, 12-1 
#define directive ...........0.. 3-6, 3-13, 3-39 
DP CCE CIE SSI sncccenrsossceterensnioneriin 3-16 
Display file COMMA scsasssvancesanienens 7-22 
Display file window..............0. 7-22, 7-23 
EP LIT JOG xsarecsavesssinimcnrstaceron A-13 
NSPE Fe scipencos tocsiens cesresd incessant 4-7, 4-8 
DYOD-GOWN TGIUG crssarsnessrseeinnessenennvnen 8—4 
Die dg) eee rere ner ner n 9-11, 11-10 
Dump (D) command ................ 9-21, 12-2 
Dump memory command............000+ 9-21 
TVA viacsptincstsnsteosiscsnonesaecaussines 9-10 
—dir switch ....... 4-8, 4-9, 4-13, 4-14, 4-16 
E 
BAA GOE sseescccecseiaans 4-1, 4-13, 5-13, B-2 
Emulator MEMOLY MAP xs sewwessavnenres 2-11 
INCE strscaniccspcats cca sheer danicieta ht eantos a Aadenaten eigtiaee 7-15 
Hendif Cirective ...........ccceseesseeereeeseeees 3-14 
NDMOD  Girective cssiccccisimscnssnnancnse 3-23 
JENIDS YS GIbSCH Ve sessactsoscassrasnnsasesnmoesons 2-8 
ENTRY Give Chive ...ccnrcccasancaetene 4-13,4-14 
Environment variables................scee0 7-4 
Evaluating expressiON ............ cee 12-6 
-EXE file....... 3-35, 3-44, 3-45, 4-10, 4-19, 

5-1, 5-2, 5-4, 5-6, 5-9, 5-13, 10-1, B-1 
EXEC ADS TS csmucnsesonessnanensivomsnnnsenasnaene 7-5 
Executable program 

bakenacontesins seer 4-1, 4-10, 5-6, 5-8, 10-1 
EXGCUTION CY CICS sccciacscnroinoeneseavenennsnet 10-29 
EXE COMMIMATIG. sinenscsessenvnservinserens 8-15, 8-19 
Exiting the simulator 
nitesuaaetileuseees seeseeeeeee O- 15D, 8-19, 12-1, 12-3 
EX YCSSIOTNG) seccoinssninncsaniconis 6-6, 6-7, 10-22 


Expressions (arithmetic, logical) ......3-10 


EXpTresSiONS COMIMANG ........00000+-es000 12-5 
Expressions window ...........0+ 12-5, 12-7 
EXTERNAL directive ....3-—37, 4-13, 4-14 
External MGMOLY «.csccscesascreenes 4-11, 4-17 
External program memory..........::0+ 3-25 
PUB GILT ecsaseisisseucucaccscnntsnsmsnaciaomdeasssamieass 8-3 
- 
Fast Wren y TG seccinssmesicans 4-10, 4-15, 4-16 
DE ra ithagesaesaradisteieereeneaiens 9-10 
PNG Ssasien cisnasins sisintaasstaneaaidetaatininiciemsaneesens 8-12 
PTCTRANINE: scicnstenss snnrnnicsisnexwieanonicnnaanensis 6-4, 6-8 
Fill command .......... 9-25, 9-26, 9-27, F-2 
Find (F) command ..............cccceeeeeeeeeees 9-22 
Fixed-point data format...............64 11-25 
Flag registers WINdOW ..........ss:eeeee 9-10 
Floating-point data format........ 6-25, F-1 
FP) scxsoenteesnstetonspca nantes pein Gieeatoeorenciens 9-10, 9-12 
FROG TOMAS saccsiansssestrinssssienaessccaancassaanseias 4-9 
G 
= NRT ceeccreananensénepitaierisenaneratiptaitiestbicenbis 6-5 
General Purpose TEBISLETS wsccarsevonnsniscns 9-3 
.GLOBAL directive ..............0000. 3-36, 4-13 
CARA LB VIDONS camanancnsnneomsoainetans 3-9 
Global data structures ............ccccceceee 3-41 
Go (G) command ........... 7-18, 7-21, 7-33, 

7-36, 9-20 
Graphical user interface (GUI) ...8-1, 8-4 
H 
PID POPISICS snscivinmctconcatorerncis 5-13, B-6 
DARED sasciccn biaccsnstciieioladnconanu ete 4-5,4-9, 4-10 
PTD FE xieisuepnicpenaiiateasrecnpueseaisiiiacayiacinet 4-10 
RLS TCS siinesasnniniincnasransnecenanatanaiciensiatss 8-19 
SANE STEEL scaesaiscsssrnctevihanss vbwbuicenn 7-5, 8-3 
Hexadecimal .............00005.0 6-4, 11-25, F—1 
HULP beet Te (HIPPY ssmsasixieceas isccames sawnavss 10-4 
TLR CTI ascetics iiins Gineernnsaeeoded dunes 10-5 
HIP data files.....11-18, 11-20, 11-21, F-2 
HIP data register (HDR) .....:.:00c:ss0000 11-14 
HIP files window................0: 11-18, 11-19 
HIP read (HIPR) command 

ceva cseioeseaneaataeeaneenee 11-18, 11-19, 11-20 
HIP registers window 

devesuseelis 9-13, 9-14, 11-14, 11-15, 11-16 
HIP splitter utility .......000. 5-13, 10-4, B-6 
PALE SEAS TECISIEL sssexemsrerernemennmis 11-17 


HIP write (HIPW) command 


sedina uaeciasevibeanetsendiosts 11-19, 11-20, 11-21 
DI i sicisssi tcceicncssinpipa a binant tceiseasesresncienineniis 7-15 
Host interface port (HIP)........ 5-13, 10-4, 


11-1, 11-14, 11-16, 11-17 
HSR (HIP status register) ....11-15, 11-17 


| 
EL PORISIELS seisiriscrnmnenrieins 3-12, 3-22, 3-32 
=i SWItCHN ..... cece cee eeeseeeeeeeee 4-3, 4-5, 4-15 
FE -wctteoscoticceceteceriesior seetenn-saecnees! 9-7 
LRT EPO Y ais viasinca vccivviniie sxnnierarsnsinenssesonnndinninn 3-13 
WS icceopinteeceneszectecetiacuasenamenne 10-28 
TE tuisboceagaussinvtiient@ieusetaensacmantotadsaccedacs 9-7 
Hifdef Girective ..........ccccccccccccsccceeeeeeeees 3-14 
TF, vecsas ansavrascionasvecmnasias 9-7, 9-17, 10-8 
ee a 9-15, 11-23 
Hinclude Cirective ..........cccccccseseeeseeeeees 3-37 
INCLUDE directories.............ccccccccees 1-12 
Indirect AdAressING ...cs00s.cssnensss 3-16, 3-22 
Tcirect List Ge ...cccconnnecseoneceseenencess 4-3, 4-5 
INIT directive ........0... 3-28, 4-1, 4-3, B-1 
[Hit Ali ZAtION scsssscvssssnccsscsoevessesasens 5-8, 5-11 
Trritialization: atta occcscseessesmnsseoes 3-33, 4-10 
Initialization data files......... 4-1, 4-3, B-1 
TANG ERTS LIOR, ssisswiaonncstnrsensooamsmersiaanvanesersanens 5-5 
TEACRIOE CY CIES cs niciccmnsmnaiccnresionsmnson 10-29 
Titel Hex TOCOP socincsccssssaassrssexssnnssiencaes 5-2 
Internal data memory ................ 2-3, 3-16 
TAPEPNAL MEMOTY sccrsssnnsssassnsenesaswrassranes 4-17 
Internal program memory 

segudespeructesieeces 2-6, 3-24, 3-36, 3-45, 4-18 
Enterrtapt (1) COMMA scnsnercreracsaronaes 7-36 
IPEEPT PE DIE secs nisentnvannenssanennnnsninne 10-5 
OPTUS as sssanccscersnersarensesantenatess 7-32, 7-34 
FT EE ccituiecanciintesetesntaribavtantaledadocnaass 9-12 
aL ah: ee er 9-12 
Ef OO OTL ciisinsttse nisin tevietavercantent 2-21, 2-22 
I/O port data file 

semana tesaetene 11-1, 11-2, 11-3, 11-4, F-1 
I/O port (parallel) 

sisstiscunaianuceeesecvastuises 11-1, 11-2, 11-4, 11-5 
Be wasceoieectuaeeasienevenesenaeentecses 9-15, 11-23 
BY scccntisssniessnisten haaisetadiastecee earns 9-7, 10-8 
DIR PG incsccearnicnvinnnsnnnctonaivoansions 9-11, 9-12, 11-11 
1S | oe ern 10-5, 10-7 
eo eintanctnasntoreedconaeses 10-5, 10-7 
|: SC a re a 10-5, 10-7 
Ee wdsapdasseecenrenionnwetenn 10-5, 10-7 
Ta bie saoeewsiavitearrateveckouane 9-12, 11-11 
LP 9 reseacecinstateneeeetedesaciess 9-11, 9-12, 11-10 


J-K 
PUTAS: scniccrrcaxzinacion cussions sisnirecenessitveniion 3-41, 4-14 
—k SWiItCH o0..... cece ceccceceeessescsssscccescceseeeeees 8-3 
KeysttOke Te crmrcassssonen: 7-6, 10-15, 10-17 
BIG asridiwnsisnha wena ss cheiceopennpsseoisiniss 3-9 
i. 
Li DESISIASS cisanainiavesisacssorersascress O= 12, BOZ 
LADE|IS snssssscsvesceersens 3-16, 3-39, 3-41, 4-13, 
4-14, 4-23, 8-12 
LIB GiveChOT iG sccccecssnenpssnnvosnernvcene 1-12, 4-7 
lib SWitCh ou... ceceeeeceesesssssesesssseeeees 4-16 
LIB 2) TL vecsccsecssas 4-5, 4-10, 4-15, 4-16 
LATICES: ssecsersceseaexcsuvssntcondixncnanes 4-7, 4-25 
LADrarY GCS: orssacsevsennvirssssins 4-9, 4-13, 4-25 
LADTALY TOULMES: vr scmnassinns 4-5, 4-10, 4-14, 
4-15, 4-17 
LAR OAL DURE oe cocsssecssecessncnssessseareseacnaann 3-29 
LS OY Se ccesinicenecasccanien 3-44, 3-45, 5-13, 6-2, 
6—5, 7-8, 10-2, B-1, B-2, B-4 
List windows command ..............006868 8-10 
Load (L) command ...............06 7-13, 7-28 
Loader routines......... 3-36, 5-8, 5-9, 5-10 
—loader switch ............c ee 3-45, 5-8, 5-9, 
5-11, 5-12 
ESIC 0 TIE. sexscersesicnnsncrinaioninsins 7-12, 7-28 
Loading a window file............. 8-16, 12-2 
LCAEE SPI S a sinirnesacannvnvinns 9-22, 12-8 
LOOP GEG secites sxernnesiceoncaviensvcerevcncenandnonetss 9-16 
Lapp ache CB) sosessncnesnvetssnenvonensinrannss 11-13 
iE SANG cscctvccesriastesndieeeceavens 3-7, 3-40, 3-46 
M 
I TSU acs sciaractncistenecenicpioninias 3-22, 3-32 
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